@thisisagile/easy-service 17.0.0

package/dist/index.js

@@ -0,0 +1,225 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result)
+    __defProp(target, key, result);
+  return result;
+};
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  HealthResource: () => HealthResource,
+  HealthUri: () => HealthUri,
+  Jwt: () => Jwt,
+  OriginatedError: () => OriginatedError,
+  Requires: () => Requires,
+  Service: () => Service,
+  del: () => del,
+  get: () => get,
+  isOriginatedError: () => isOriginatedError,
+  patch: () => patch,
+  post: () => post,
+  put: () => put,
+  requires: () => requires,
+  route: () => route,
+  routes: () => routes,
+  search: () => search,
+  stream: () => stream,
+  toOriginatedError: () => toOriginatedError,
+  toVerbOptions: () => toVerbOptions
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/health/HealthResource.ts
+var import_easy4 = require("@thisisagile/easy");
+
+// src/health/HealthUri.ts
+var import_easy = require("@thisisagile/easy");
+var HealthUri = class _HealthUri extends import_easy.EasyUri {
+  static health = import_easy.uri.segment("health");
+  static Health = new _HealthUri([_HealthUri.health]);
+};
+
+// src/resources/Route.ts
+var import_easy2 = require("@thisisagile/easy");
+var route = (uri2) => (subject) => {
+  (0, import_easy2.meta)(subject).set("route", uri2);
+};
+var toRoute = (endpoint, requires2, verb, middleware) => (0, import_easy2.tryTo)(verb).is.defined().map((verb2) => ({ verb: verb2, endpoint, requires: requires2, middleware: middleware ?? [] })).orElse();
+var Router = class {
+  constructor(resource) {
+    this.resource = resource;
+  }
+  get route() {
+    return (0, import_easy2.meta)(this.resource).get("route");
+  }
+  get middleware() {
+    return (0, import_easy2.meta)(this.resource).get("middleware") ?? [];
+  }
+  get endpoints() {
+    return (0, import_easy2.meta)(this.resource).properties("verb").mapDefined(
+      (v) => toRoute(
+        this.resource[v.property],
+        {
+          labCoat: v.get("labCoat") ?? false,
+          token: v.get("token") ?? false,
+          scope: v.get("scope"),
+          uc: v.get("uc")
+        },
+        v.get("verb"),
+        v.get("middleware")
+      )
+    );
+  }
+};
+var routes = (resource) => new Router(resource);
+
+// src/http/Verb.ts
+var import_easy3 = require("@thisisagile/easy");
+var toVerbOptions = (options) => ({
+  onOk: options?.onOk ?? import_easy3.HttpStatus.Ok,
+  onNotFound: options?.onNotFound ?? import_easy3.HttpStatus.NotFound,
+  onError: options?.onError ?? import_easy3.HttpStatus.BadRequest,
+  type: options?.type ?? import_easy3.ContentType.Json,
+  cache: options?.cache ?? import_easy3.CacheControl.disabled()
+});
+var toVerb = (verb, options) => (subject, property) => {
+  (0, import_easy3.meta)(subject).property(property).set("verb", { verb, options });
+};
+var get = (options) => toVerb(import_easy3.HttpVerb.Get, options);
+var search = (options) => toVerb(import_easy3.HttpVerb.Get, { onNotFound: import_easy3.HttpStatus.Ok, ...options });
+var put = (options) => toVerb(import_easy3.HttpVerb.Put, options);
+var patch = (options) => toVerb(import_easy3.HttpVerb.Patch, options);
+var post = (options) => toVerb(import_easy3.HttpVerb.Post, { onOk: import_easy3.HttpStatus.Created, ...options });
+var del = (options) => toVerb(import_easy3.HttpVerb.Delete, { onOk: import_easy3.HttpStatus.NoContent, ...options });
+var stream = (options) => toVerb(import_easy3.HttpVerb.Get, { type: import_easy3.ContentType.Stream, ...options });
+
+// src/health/HealthResource.ts
+var HealthResource = class {
+  ok = () => (0, import_easy4.resolve)({ state: "Service is healthy." });
+};
+__decorateClass([
+  get()
+], HealthResource.prototype, "ok", 2);
+HealthResource = __decorateClass([
+  route(HealthUri.Health)
+], HealthResource);
+
+// src/http/OriginatedError.ts
+var import_easy5 = require("@thisisagile/easy");
+var OriginatedError = class extends Error {
+  constructor(origin, options) {
+    super();
+    this.origin = origin;
+    this.options = options;
+    if ((0, import_easy5.isError)(origin))
+      this.stack = origin.stack;
+  }
+};
+var isOriginatedError = (e) => (0, import_easy5.isError)(e) && e instanceof OriginatedError;
+var toOriginatedError = (e, options) => isOriginatedError(e) ? e : new OriginatedError(e, options);
+
+// src/resources/Requires.ts
+var import_easy6 = require("@thisisagile/easy");
+var Requires = class {
+  labCoat = () => (subject, property) => {
+    (0, import_easy6.meta)(subject).property(property).set("labCoat", true);
+  };
+  token = () => (subject, property) => {
+    (0, import_easy6.meta)(subject).property(property).set("token", true);
+  };
+  scope = (scope) => (subject, property) => {
+    (0, import_easy6.meta)(subject).property(property).set("token", true);
+    (0, import_easy6.meta)(subject).property(property).set("scope", scope);
+  };
+  useCase = (uc) => (subject, property) => {
+    (0, import_easy6.meta)(subject).property(property).set("token", true);
+    (0, import_easy6.meta)(subject).property(property).set("uc", uc);
+  };
+};
+var requires = new Requires();
+
+// src/resources/Service.ts
+var import_easy7 = require("@thisisagile/easy");
+var Service = class extends import_easy7.Enum {
+  constructor(name, app, resources = (0, import_easy7.toList)()) {
+    super(name);
+    this.name = name;
+    this.app = app;
+    this.resources = resources;
+  }
+  port = 8080;
+  pre = () => [];
+  post = () => [];
+  with(...resources) {
+    return (0, import_easy7.tryTo)(this).accept((t) => t.resources.add(resources.map((r) => new r()))).value;
+  }
+  atPort(port) {
+    return (0, import_easy7.tryTo)(this).accept((t) => t.port = port).value;
+  }
+  start(message = `Service ${this.name} listening on port ${this.port} with ${this.resources.length} resources.`) {
+    (0, import_easy7.tryTo)(this).accept((t) => t.pre().forEach((h) => this.app.use(h))).accept((t) => t.resources.forEach((r) => this.app.route(this, r))).accept((t) => t.post().forEach((h) => this.app.use(h))).accept((t) => t.app.listen(this.port, message));
+  }
+};
+
+// src/security/Jwt.ts
+var import_jsonwebtoken = require("jsonwebtoken");
+var import_easy8 = require("@thisisagile/easy");
+var Jwt = class _Jwt extends import_easy8.Jwt {
+  static of = (a) => new _Jwt(a.jwt);
+  get isValid() {
+    return (0, import_easy8.tryTo)(() => import_easy8.ctx.env.get("tokenPublicKey") ?? "").map((key) => (0, import_jsonwebtoken.verify)(this.value, key)).map(() => true).orElse() ?? false;
+  }
+  static sign = (token, options) => (0, import_easy8.tryTo)(() => import_easy8.ctx.env.get("tokenPrivateKey") ?? "").is.not.empty().map(
+    (key) => (0, import_jsonwebtoken.sign)(token, key, {
+      ...options,
+      expiresIn: import_easy8.ctx.env.get("tokenExpiresIn") ?? "1h",
+      keyid: import_easy8.ctx.env.get("tokenKeyid") ?? "easy",
+      algorithm: import_easy8.ctx.env.get("tokenAlgorithm", "RS256")
+    })
+  ).map((s) => new _Jwt(s)).value;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HealthResource,
+  HealthUri,
+  Jwt,
+  OriginatedError,
+  Requires,
+  Service,
+  del,
+  get,
+  isOriginatedError,
+  patch,
+  post,
+  put,
+  requires,
+  route,
+  routes,
+  search,
+  stream,
+  toOriginatedError,
+  toVerbOptions
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/health/HealthResource.ts","../src/health/HealthUri.ts","../src/resources/Route.ts","../src/http/Verb.ts","../src/http/OriginatedError.ts","../src/resources/Requires.ts","../src/resources/Service.ts","../src/security/Jwt.ts"],"sourcesContent":["export * from './health/HealthResource';\nexport * from './health/HealthUri';\nexport * from './http/OriginatedError';\nexport * from './http/Verb';\nexport * from './resources/AppProvider';\nexport * from './resources/Requires';\nexport * from './resources/Resource';\nexport * from './resources/Route';\nexport * from './resources/Service';\nexport * from './security/Jwt';\n","import { resolve, Json } from '@thisisagile/easy';\nimport { HealthUri } from './HealthUri';\nimport { Resource } from '../resources/Resource';\nimport { route } from '../resources/Route';\nimport { get } from '../http/Verb';\n\n@route(HealthUri.Health)\nexport class HealthResource implements Resource {\n  @get()\n  ok = (): Promise<Json> => resolve({ state: 'Service is healthy.' });\n}\n","import { EasyUri, uri } from '@thisisagile/easy';\n\nexport class HealthUri extends EasyUri {\n  static readonly health = uri.segment('health');\n  static readonly Health = new HealthUri([HealthUri.health]);\n}\n","import { List, meta, Optional, tryTo, Uri, Scope, UseCase, Req } from '@thisisagile/easy';\nimport { Resource } from './Resource';\nimport { RequestHandler } from 'express';\nimport { Verb } from '../http/Verb';\n\nexport const route =\n  (uri: Uri): ClassDecorator =>\n  (subject: unknown): void => {\n    meta(subject).set('route', uri);\n  };\n\nexport type Endpoint<T = unknown> = (re: Req) => Promise<T | List<T>>;\nexport type RouteRequires = { token: boolean; labCoat: boolean; scope?: Scope; uc?: UseCase };\nexport type Route = { verb: Verb; endpoint: Endpoint; requires: RouteRequires; middleware: RequestHandler[] };\nexport type Routes = { route: Uri; middleware: RequestHandler[]; endpoints: List<Route> };\n\nconst toRoute = (endpoint: Endpoint, requires: RouteRequires, verb?: Verb, middleware?: RequestHandler[]): Optional<Route> =>\n  tryTo(verb)\n    .is.defined()\n    .map(verb => ({ verb, endpoint, requires, middleware: middleware ?? [] }) as Route)\n    .orElse();\n\nclass Router implements Routes {\n  constructor(readonly resource: Resource) {}\n\n  get route(): Uri {\n    return meta(this.resource).get('route');\n  }\n\n  get middleware(): RequestHandler[] {\n    return meta(this.resource).get<RequestHandler[]>('middleware') ?? [];\n  }\n\n  get endpoints(): List<Route> {\n    return meta(this.resource)\n      .properties('verb')\n      .mapDefined(v =>\n        toRoute(\n          this.resource[v.property],\n          {\n            labCoat: v.get<boolean>('labCoat') ?? false,\n            token: v.get<boolean>('token') ?? false,\n            scope: v.get<Scope>('scope'),\n            uc: v.get<UseCase>('uc'),\n          },\n          v.get<Verb>('verb'),\n          v.get<RequestHandler[]>('middleware')\n        )\n      );\n  }\n}\n\nexport const routes = (resource: Resource): Routes => new Router(resource);\n","import { meta, CacheControl, ContentType, HttpStatus, HttpVerb } from '@thisisagile/easy';\n\nexport type VerbOptions = { onOk?: HttpStatus; onNotFound?: HttpStatus; onError?: HttpStatus; type?: ContentType; cache?: CacheControl };\nexport type Verb = { verb: HttpVerb; options: VerbOptions };\n\nexport const toVerbOptions = (options?: VerbOptions): Required<VerbOptions> => ({\n  onOk: options?.onOk ?? HttpStatus.Ok,\n  onNotFound: options?.onNotFound ?? HttpStatus.NotFound,\n  onError: options?.onError ?? HttpStatus.BadRequest,\n  type: options?.type ?? ContentType.Json,\n  cache: options?.cache ?? CacheControl.disabled(),\n});\n\nconst toVerb =\n  <T>(verb: HttpVerb, options?: VerbOptions): PropertyDecorator =>\n  (subject: unknown, property: string | symbol): void => {\n    meta(subject).property(property).set('verb', { verb, options });\n  };\n\nexport const get = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Get, options);\n\nexport const search = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Get, { onNotFound: HttpStatus.Ok, ...options });\n\nexport const put = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Put, options);\n\nexport const patch = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Patch, options);\n\nexport const post = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Post, { onOk: HttpStatus.Created, ...options });\n\nexport const del = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Delete, { onOk: HttpStatus.NoContent, ...options });\n\nexport const stream = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Get, { type: ContentType.Stream, ...options });\n","import { ErrorOrigin, isError } from '@thisisagile/easy';\nimport { VerbOptions } from './Verb';\n\nexport class OriginatedError extends Error {\n  constructor(\n    readonly origin: ErrorOrigin,\n    readonly options?: VerbOptions\n  ) {\n    super();\n    if (isError(origin)) this.stack = origin.stack;\n  }\n}\n\nexport const isOriginatedError = (e?: unknown): e is OriginatedError => isError(e) && e instanceof OriginatedError;\n\nexport const toOriginatedError = (e: unknown, options?: VerbOptions): OriginatedError =>\n  isOriginatedError(e) ? e : new OriginatedError(e as ErrorOrigin, options);\n","import { meta } from '@thisisagile/easy';\nimport { Scope, UseCase } from '@thisisagile/easy';\n\nexport class Requires {\n  readonly labCoat =\n    (): PropertyDecorator =>\n    (subject: unknown, property: string | symbol): void => {\n      meta(subject).property(property).set('labCoat', true);\n    };\n\n  readonly token =\n    (): PropertyDecorator =>\n    (subject: unknown, property: string | symbol): void => {\n      meta(subject).property(property).set('token', true);\n    };\n\n  readonly scope =\n    (scope: Scope): PropertyDecorator =>\n    (subject: unknown, property: string | symbol): void => {\n      meta(subject).property(property).set('token', true);\n      meta(subject).property(property).set('scope', scope);\n    };\n\n  readonly useCase =\n    (uc: UseCase): PropertyDecorator =>\n    (subject: unknown, property: string | symbol): void => {\n      meta(subject).property(property).set('token', true);\n      meta(subject).property(property).set('uc', uc);\n    };\n}\n\nexport const requires = new Requires();\n","import { AppProvider, Handler } from './AppProvider';\nimport { Constructor, Enum, List, toList, tryTo } from '@thisisagile/easy';\nimport { Resource } from './Resource';\n\nexport class Service extends Enum {\n  protected port = 8080;\n\n  constructor(\n    readonly name: string,\n    protected app: AppProvider,\n    protected resources: List<Resource> = toList()\n  ) {\n    super(name);\n  }\n\n  pre = (): Handler[] => [];\n  post = (): Handler[] => [];\n\n  with(...resources: Constructor<Resource>[]): this {\n    return tryTo(this).accept(t => t.resources.add(resources.map(r => new r()))).value;\n  }\n\n  atPort(port: number): this {\n    return tryTo(this).accept(t => (t.port = port)).value;\n  }\n\n  start(message = `Service ${this.name} listening on port ${this.port} with ${this.resources.length} resources.`): void {\n    tryTo(this)\n      .accept(t => t.pre().forEach(h => this.app.use(h)))\n      .accept(t => t.resources.forEach(r => this.app.route(this, r)))\n      .accept(t => t.post().forEach(h => this.app.use(h)))\n      .accept(t => t.app.listen(this.port, message));\n  }\n}\n","import { Algorithm, sign, verify } from 'jsonwebtoken';\nimport { ctx, Json, OneOrMore, Optional, tryTo, Validatable, Jwt as JwtBase } from '@thisisagile/easy';\n\ninterface SignOptions {\n  audience?: Optional<OneOrMore<string>>;\n  issuer?: Optional<string>;\n}\nexport class Jwt extends JwtBase implements Validatable {\n  static of = (a: { jwt: string }): Jwt => new Jwt(a.jwt);\n\n  get isValid(): boolean {\n    return (\n      tryTo(() => ctx.env.get('tokenPublicKey') ?? '')\n        .map(key => verify(this.value, key))\n        .map(() => true)\n        .orElse() ?? false\n    );\n  }\n\n  static sign = (token: Json, options?: SignOptions): Jwt =>\n    tryTo(() => ctx.env.get('tokenPrivateKey') ?? '')\n      .is.not.empty()\n      .map(key =>\n        sign(token, key, {\n          ...options,\n          expiresIn: ctx.env.get('tokenExpiresIn') ?? '1h',\n          keyid: ctx.env.get('tokenKeyid') ?? 'easy',\n          algorithm: ctx.env.get('tokenAlgorithm', 'RS256') as Algorithm,\n        })\n      )\n      .map(s => new Jwt(s)).value;\n}\n"],"mappings":"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","names":["import_easy","import_easy","uri","requires","verb","import_easy","import_easy","import_easy","import_easy","import_easy","JwtBase"]}

package/dist/index.mjs

@@ -0,0 +1,11 @@
+export * from "./health/HealthResource";
+export * from "./health/HealthUri";
+export * from "./http/OriginatedError";
+export * from "./http/Verb";
+export * from "./resources/AppProvider";
+export * from "./resources/Requires";
+export * from "./resources/Resource";
+export * from "./resources/Route";
+export * from "./resources/Service";
+export * from "./security/Jwt";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './health/HealthResource';\nexport * from './health/HealthUri';\nexport * from './http/OriginatedError';\nexport * from './http/Verb';\nexport * from './resources/AppProvider';\nexport * from './resources/Requires';\nexport * from './resources/Resource';\nexport * from './resources/Route';\nexport * from './resources/Service';\nexport * from './security/Jwt';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/resources/AppProvider.d.ts

@@ -0,0 +1,9 @@
+import { Resource } from './Resource';
+import { Service } from './Service';
+import { Func } from '@thisisagile/easy';
+export type Handler = Func<void, any>;
+export interface AppProvider {
+    use: (h: Handler) => void;
+    route: (s: Service, r: Resource) => void;
+    listen: (port: number, message?: string) => void;
+}

package/dist/resources/AppProvider.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=AppProvider.mjs.map

package/dist/resources/AppProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/resources/Requires.d.ts

@@ -0,0 +1,8 @@
+import { Scope, UseCase } from '@thisisagile/easy';
+export declare class Requires {
+    readonly labCoat: () => PropertyDecorator;
+    readonly token: () => PropertyDecorator;
+    readonly scope: (scope: Scope) => PropertyDecorator;
+    readonly useCase: (uc: UseCase) => PropertyDecorator;
+}
+export declare const requires: Requires;

package/dist/resources/Requires.mjs

@@ -0,0 +1,26 @@
+import "../chunk-4N72FQFX.mjs";
+
+// src/resources/Requires.ts
+import { meta } from "@thisisagile/easy";
+var Requires = class {
+  labCoat = () => (subject, property) => {
+    meta(subject).property(property).set("labCoat", true);
+  };
+  token = () => (subject, property) => {
+    meta(subject).property(property).set("token", true);
+  };
+  scope = (scope) => (subject, property) => {
+    meta(subject).property(property).set("token", true);
+    meta(subject).property(property).set("scope", scope);
+  };
+  useCase = (uc) => (subject, property) => {
+    meta(subject).property(property).set("token", true);
+    meta(subject).property(property).set("uc", uc);
+  };
+};
+var requires = new Requires();
+export {
+  Requires,
+  requires
+};
+//# sourceMappingURL=Requires.mjs.map

package/dist/resources/Requires.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/resources/Requires.ts"],"sourcesContent":["import { meta } from '@thisisagile/easy';\nimport { Scope, UseCase } from '@thisisagile/easy';\n\nexport class Requires {\n  readonly labCoat =\n    (): PropertyDecorator =>\n    (subject: unknown, property: string | symbol): void => {\n      meta(subject).property(property).set('labCoat', true);\n    };\n\n  readonly token =\n    (): PropertyDecorator =>\n    (subject: unknown, property: string | symbol): void => {\n      meta(subject).property(property).set('token', true);\n    };\n\n  readonly scope =\n    (scope: Scope): PropertyDecorator =>\n    (subject: unknown, property: string | symbol): void => {\n      meta(subject).property(property).set('token', true);\n      meta(subject).property(property).set('scope', scope);\n    };\n\n  readonly useCase =\n    (uc: UseCase): PropertyDecorator =>\n    (subject: unknown, property: string | symbol): void => {\n      meta(subject).property(property).set('token', true);\n      meta(subject).property(property).set('uc', uc);\n    };\n}\n\nexport const requires = new Requires();\n"],"mappings":";;;AAAA,SAAS,YAAY;AAGd,IAAM,WAAN,MAAe;AAAA,EACX,UACP,MACA,CAAC,SAAkB,aAAoC;AACrD,SAAK,OAAO,EAAE,SAAS,QAAQ,EAAE,IAAI,WAAW,IAAI;AAAA,EACtD;AAAA,EAEO,QACP,MACA,CAAC,SAAkB,aAAoC;AACrD,SAAK,OAAO,EAAE,SAAS,QAAQ,EAAE,IAAI,SAAS,IAAI;AAAA,EACpD;AAAA,EAEO,QACP,CAAC,UACD,CAAC,SAAkB,aAAoC;AACrD,SAAK,OAAO,EAAE,SAAS,QAAQ,EAAE,IAAI,SAAS,IAAI;AAClD,SAAK,OAAO,EAAE,SAAS,QAAQ,EAAE,IAAI,SAAS,KAAK;AAAA,EACrD;AAAA,EAEO,UACP,CAAC,OACD,CAAC,SAAkB,aAAoC;AACrD,SAAK,OAAO,EAAE,SAAS,QAAQ,EAAE,IAAI,SAAS,IAAI;AAClD,SAAK,OAAO,EAAE,SAAS,QAAQ,EAAE,IAAI,MAAM,EAAE;AAAA,EAC/C;AACJ;AAEO,IAAM,WAAW,IAAI,SAAS;","names":[]}

package/dist/resources/Resource.d.ts

@@ -0,0 +1 @@
+export type Resource = any;

package/dist/resources/Resource.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=Resource.mjs.map

package/dist/resources/Resource.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/resources/Route.d.ts

@@ -0,0 +1,24 @@
+import { List, Uri, Scope, UseCase, Req } from '@thisisagile/easy';
+import { Resource } from './Resource';
+import { RequestHandler } from 'express';
+import { Verb } from '../http/Verb';
+export declare const route: (uri: Uri) => ClassDecorator;
+export type Endpoint<T = unknown> = (re: Req) => Promise<T | List<T>>;
+export type RouteRequires = {
+    token: boolean;
+    labCoat: boolean;
+    scope?: Scope;
+    uc?: UseCase;
+};
+export type Route = {
+    verb: Verb;
+    endpoint: Endpoint;
+    requires: RouteRequires;
+    middleware: RequestHandler[];
+};
+export type Routes = {
+    route: Uri;
+    middleware: RequestHandler[];
+    endpoints: List<Route>;
+};
+export declare const routes: (resource: Resource) => Routes;

package/dist/resources/Route.mjs

@@ -0,0 +1,10 @@
+import {
+  route,
+  routes
+} from "../chunk-FYPLZQRO.mjs";
+import "../chunk-4N72FQFX.mjs";
+export {
+  route,
+  routes
+};
+//# sourceMappingURL=Route.mjs.map

package/dist/resources/Route.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/resources/Service.d.ts

@@ -0,0 +1,15 @@
+import { AppProvider, Handler } from './AppProvider';
+import { Constructor, Enum, List } from '@thisisagile/easy';
+import { Resource } from './Resource';
+export declare class Service extends Enum {
+    readonly name: string;
+    protected app: AppProvider;
+    protected resources: List<Resource>;
+    protected port: number;
+    constructor(name: string, app: AppProvider, resources?: List<Resource>);
+    pre: () => Handler[];
+    post: () => Handler[];
+    with(...resources: Constructor<Resource>[]): this;
+    atPort(port: number): this;
+    start(message?: string): void;
+}

package/dist/resources/Service.mjs

@@ -0,0 +1,28 @@
+import "../chunk-4N72FQFX.mjs";
+
+// src/resources/Service.ts
+import { Enum, toList, tryTo } from "@thisisagile/easy";
+var Service = class extends Enum {
+  constructor(name, app, resources = toList()) {
+    super(name);
+    this.name = name;
+    this.app = app;
+    this.resources = resources;
+  }
+  port = 8080;
+  pre = () => [];
+  post = () => [];
+  with(...resources) {
+    return tryTo(this).accept((t) => t.resources.add(resources.map((r) => new r()))).value;
+  }
+  atPort(port) {
+    return tryTo(this).accept((t) => t.port = port).value;
+  }
+  start(message = `Service ${this.name} listening on port ${this.port} with ${this.resources.length} resources.`) {
+    tryTo(this).accept((t) => t.pre().forEach((h) => this.app.use(h))).accept((t) => t.resources.forEach((r) => this.app.route(this, r))).accept((t) => t.post().forEach((h) => this.app.use(h))).accept((t) => t.app.listen(this.port, message));
+  }
+};
+export {
+  Service
+};
+//# sourceMappingURL=Service.mjs.map

package/dist/resources/Service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/resources/Service.ts"],"sourcesContent":["import { AppProvider, Handler } from './AppProvider';\nimport { Constructor, Enum, List, toList, tryTo } from '@thisisagile/easy';\nimport { Resource } from './Resource';\n\nexport class Service extends Enum {\n  protected port = 8080;\n\n  constructor(\n    readonly name: string,\n    protected app: AppProvider,\n    protected resources: List<Resource> = toList()\n  ) {\n    super(name);\n  }\n\n  pre = (): Handler[] => [];\n  post = (): Handler[] => [];\n\n  with(...resources: Constructor<Resource>[]): this {\n    return tryTo(this).accept(t => t.resources.add(resources.map(r => new r()))).value;\n  }\n\n  atPort(port: number): this {\n    return tryTo(this).accept(t => (t.port = port)).value;\n  }\n\n  start(message = `Service ${this.name} listening on port ${this.port} with ${this.resources.length} resources.`): void {\n    tryTo(this)\n      .accept(t => t.pre().forEach(h => this.app.use(h)))\n      .accept(t => t.resources.forEach(r => this.app.route(this, r)))\n      .accept(t => t.post().forEach(h => this.app.use(h)))\n      .accept(t => t.app.listen(this.port, message));\n  }\n}\n"],"mappings":";;;AACA,SAAsB,MAAY,QAAQ,aAAa;AAGhD,IAAM,UAAN,cAAsB,KAAK;AAAA,EAGhC,YACW,MACC,KACA,YAA4B,OAAO,GAC7C;AACA,UAAM,IAAI;AAJD;AACC;AACA;AAAA,EAGZ;AAAA,EARU,OAAO;AAAA,EAUjB,MAAM,MAAiB,CAAC;AAAA,EACxB,OAAO,MAAiB,CAAC;AAAA,EAEzB,QAAQ,WAA0C;AAChD,WAAO,MAAM,IAAI,EAAE,OAAO,OAAK,EAAE,UAAU,IAAI,UAAU,IAAI,OAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;AAAA,EAC/E;AAAA,EAEA,OAAO,MAAoB;AACzB,WAAO,MAAM,IAAI,EAAE,OAAO,OAAM,EAAE,OAAO,IAAK,EAAE;AAAA,EAClD;AAAA,EAEA,MAAM,UAAU,WAAW,KAAK,IAAI,sBAAsB,KAAK,IAAI,SAAS,KAAK,UAAU,MAAM,eAAqB;AACpH,UAAM,IAAI,EACP,OAAO,OAAK,EAAE,IAAI,EAAE,QAAQ,OAAK,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EACjD,OAAO,OAAK,EAAE,UAAU,QAAQ,OAAK,KAAK,IAAI,MAAM,MAAM,CAAC,CAAC,CAAC,EAC7D,OAAO,OAAK,EAAE,KAAK,EAAE,QAAQ,OAAK,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAClD,OAAO,OAAK,EAAE,IAAI,OAAO,KAAK,MAAM,OAAO,CAAC;AAAA,EACjD;AACF;","names":[]}

package/dist/security/Jwt.d.ts

@@ -0,0 +1,13 @@
+import { Json, OneOrMore, Optional, Validatable, Jwt as JwtBase } from '@thisisagile/easy';
+interface SignOptions {
+    audience?: Optional<OneOrMore<string>>;
+    issuer?: Optional<string>;
+}
+export declare class Jwt extends JwtBase implements Validatable {
+    static of: (a: {
+        jwt: string;
+    }) => Jwt;
+    get isValid(): boolean;
+    static sign: (token: Json, options?: SignOptions) => Jwt;
+}
+export {};

package/dist/security/Jwt.mjs

@@ -0,0 +1,23 @@
+import "../chunk-4N72FQFX.mjs";
+
+// src/security/Jwt.ts
+import { sign, verify } from "jsonwebtoken";
+import { ctx, tryTo, Jwt as JwtBase } from "@thisisagile/easy";
+var Jwt = class _Jwt extends JwtBase {
+  static of = (a) => new _Jwt(a.jwt);
+  get isValid() {
+    return tryTo(() => ctx.env.get("tokenPublicKey") ?? "").map((key) => verify(this.value, key)).map(() => true).orElse() ?? false;
+  }
+  static sign = (token, options) => tryTo(() => ctx.env.get("tokenPrivateKey") ?? "").is.not.empty().map(
+    (key) => sign(token, key, {
+      ...options,
+      expiresIn: ctx.env.get("tokenExpiresIn") ?? "1h",
+      keyid: ctx.env.get("tokenKeyid") ?? "easy",
+      algorithm: ctx.env.get("tokenAlgorithm", "RS256")
+    })
+  ).map((s) => new _Jwt(s)).value;
+};
+export {
+  Jwt
+};
+//# sourceMappingURL=Jwt.mjs.map

package/dist/security/Jwt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/security/Jwt.ts"],"sourcesContent":["import { Algorithm, sign, verify } from 'jsonwebtoken';\nimport { ctx, Json, OneOrMore, Optional, tryTo, Validatable, Jwt as JwtBase } from '@thisisagile/easy';\n\ninterface SignOptions {\n  audience?: Optional<OneOrMore<string>>;\n  issuer?: Optional<string>;\n}\nexport class Jwt extends JwtBase implements Validatable {\n  static of = (a: { jwt: string }): Jwt => new Jwt(a.jwt);\n\n  get isValid(): boolean {\n    return (\n      tryTo(() => ctx.env.get('tokenPublicKey') ?? '')\n        .map(key => verify(this.value, key))\n        .map(() => true)\n        .orElse() ?? false\n    );\n  }\n\n  static sign = (token: Json, options?: SignOptions): Jwt =>\n    tryTo(() => ctx.env.get('tokenPrivateKey') ?? '')\n      .is.not.empty()\n      .map(key =>\n        sign(token, key, {\n          ...options,\n          expiresIn: ctx.env.get('tokenExpiresIn') ?? '1h',\n          keyid: ctx.env.get('tokenKeyid') ?? 'easy',\n          algorithm: ctx.env.get('tokenAlgorithm', 'RS256') as Algorithm,\n        })\n      )\n      .map(s => new Jwt(s)).value;\n}\n"],"mappings":";;;AAAA,SAAoB,MAAM,cAAc;AACxC,SAAS,KAAgC,OAAoB,OAAO,eAAe;AAM5E,IAAM,MAAN,MAAM,aAAY,QAA+B;AAAA,EACtD,OAAO,KAAK,CAAC,MAA4B,IAAI,KAAI,EAAE,GAAG;AAAA,EAEtD,IAAI,UAAmB;AACrB,WACE,MAAM,MAAM,IAAI,IAAI,IAAI,gBAAgB,KAAK,EAAE,EAC5C,IAAI,SAAO,OAAO,KAAK,OAAO,GAAG,CAAC,EAClC,IAAI,MAAM,IAAI,EACd,OAAO,KAAK;AAAA,EAEnB;AAAA,EAEA,OAAO,OAAO,CAAC,OAAa,YAC1B,MAAM,MAAM,IAAI,IAAI,IAAI,iBAAiB,KAAK,EAAE,EAC7C,GAAG,IAAI,MAAM,EACb;AAAA,IAAI,SACH,KAAK,OAAO,KAAK;AAAA,MACf,GAAG;AAAA,MACH,WAAW,IAAI,IAAI,IAAI,gBAAgB,KAAK;AAAA,MAC5C,OAAO,IAAI,IAAI,IAAI,YAAY,KAAK;AAAA,MACpC,WAAW,IAAI,IAAI,IAAI,kBAAkB,OAAO;AAAA,IAClD,CAAC;AAAA,EACH,EACC,IAAI,OAAK,IAAI,KAAI,CAAC,CAAC,EAAE;AAC5B;","names":[]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@thisisagile/easy-service",
+  "version": "17.0.0",
+  "description": "Straightforward library for building domain-driven microservice architectures",
+  "author": "Sander Hoogendoorn",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:thisisagile/easy.git"
+  },
+  "keywords": [
+    "typescript",
+    "microservices",
+    "domain-driven-design",
+    "evolutionary-architecture"
+  ],
+  "scripts": {
+    "lint": "yarn g:eslint . --ext .js,.jsx,.ts,.tsx --fix",
+    "format": "yarn g:prettier --check --write src test *.json",
+    "build": "yarn g:tsc",
+    "build:tsup": "yarn g:tsup --onSuccess \"yarn g:tsc --emitDeclarationOnly --declaration\"",
+    "test": "yarn g:jest --coverage",
+    "prepack": "yarn g:copy-readme"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@thisisagile/easy-test": "17.0.0",
+    "@types/jsonwebtoken": "^9.0.6"
+  },
+  "dependencies": {
+    "@thisisagile/easy": "^17.0.0",
+    "jsonwebtoken": "^8.5.1"
+  }
+}

package/src/health/HealthResource.ts

@@ -0,0 +1,11 @@
+import { resolve, Json } from '@thisisagile/easy';
+import { HealthUri } from './HealthUri';
+import { Resource } from '../resources/Resource';
+import { route } from '../resources/Route';
+import { get } from '../http/Verb';
+
+@route(HealthUri.Health)
+export class HealthResource implements Resource {
+  @get()
+  ok = (): Promise<Json> => resolve({ state: 'Service is healthy.' });
+}

package/src/health/HealthUri.ts

@@ -0,0 +1,6 @@
+import { EasyUri, uri } from '@thisisagile/easy';
+
+export class HealthUri extends EasyUri {
+  static readonly health = uri.segment('health');
+  static readonly Health = new HealthUri([HealthUri.health]);
+}

package/src/http/OriginatedError.ts

@@ -0,0 +1,17 @@
+import { ErrorOrigin, isError } from '@thisisagile/easy';
+import { VerbOptions } from './Verb';
+
+export class OriginatedError extends Error {
+  constructor(
+    readonly origin: ErrorOrigin,
+    readonly options?: VerbOptions
+  ) {
+    super();
+    if (isError(origin)) this.stack = origin.stack;
+  }
+}
+
+export const isOriginatedError = (e?: unknown): e is OriginatedError => isError(e) && e instanceof OriginatedError;
+
+export const toOriginatedError = (e: unknown, options?: VerbOptions): OriginatedError =>
+  isOriginatedError(e) ? e : new OriginatedError(e as ErrorOrigin, options);

package/src/http/Verb.ts

@@ -0,0 +1,32 @@
+import { meta, CacheControl, ContentType, HttpStatus, HttpVerb } from '@thisisagile/easy';
+
+export type VerbOptions = { onOk?: HttpStatus; onNotFound?: HttpStatus; onError?: HttpStatus; type?: ContentType; cache?: CacheControl };
+export type Verb = { verb: HttpVerb; options: VerbOptions };
+
+export const toVerbOptions = (options?: VerbOptions): Required<VerbOptions> => ({
+  onOk: options?.onOk ?? HttpStatus.Ok,
+  onNotFound: options?.onNotFound ?? HttpStatus.NotFound,
+  onError: options?.onError ?? HttpStatus.BadRequest,
+  type: options?.type ?? ContentType.Json,
+  cache: options?.cache ?? CacheControl.disabled(),
+});
+
+const toVerb =
+  <T>(verb: HttpVerb, options?: VerbOptions): PropertyDecorator =>
+  (subject: unknown, property: string | symbol): void => {
+    meta(subject).property(property).set('verb', { verb, options });
+  };
+
+export const get = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Get, options);
+
+export const search = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Get, { onNotFound: HttpStatus.Ok, ...options });
+
+export const put = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Put, options);
+
+export const patch = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Patch, options);
+
+export const post = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Post, { onOk: HttpStatus.Created, ...options });
+
+export const del = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Delete, { onOk: HttpStatus.NoContent, ...options });
+
+export const stream = (options?: VerbOptions): PropertyDecorator => toVerb(HttpVerb.Get, { type: ContentType.Stream, ...options });

package/src/index.ts

@@ -0,0 +1,10 @@
+export * from './health/HealthResource';
+export * from './health/HealthUri';
+export * from './http/OriginatedError';
+export * from './http/Verb';
+export * from './resources/AppProvider';
+export * from './resources/Requires';
+export * from './resources/Resource';
+export * from './resources/Route';
+export * from './resources/Service';
+export * from './security/Jwt';

package/src/resources/AppProvider.ts

@@ -0,0 +1,11 @@
+import { Resource } from './Resource';
+import { Service } from './Service';
+import { Func } from '@thisisagile/easy';
+
+export type Handler = Func<void, any>;
+
+export interface AppProvider {
+  use: (h: Handler) => void;
+  route: (s: Service, r: Resource) => void;
+  listen: (port: number, message?: string) => void;
+}