@powersync/lib-services-framework 0.0.0-dev-20240620165410

package/LICENSE

@@ -0,0 +1,67 @@
+# Functional Source License, Version 1.1, Apache 2.0 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright 2023-2024 Journey Mobile, Inc.
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under these Terms and Conditions, as indicated by our inclusion of these Terms and Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents, Redistribution and Trademark clauses below, we hereby grant you the right to use, copy, modify, create derivative works, publicly perform, publicly display and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use means making the Software available to others in a commercial product or service that:
+
+1. substitutes for the Software;
+2. substitutes for any other product or service we offer using the Software that exists as of the date we make the Software available; or
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+2. for non-commercial education;
+3. for non-commercial research; and
+4. in connection with professional services that you provide to a licensee using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our patents, the license grant above includes a license under our patents. If you make a claim against any party that the Software infringes or contributes to the infringement of any patent, then your patent license to the Software ends immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of the Software.
+If you redistribute any copies, modifications or derivatives of the Software, you must include a copy of or a link to these Terms and Conditions and not remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of the Software, you have no right under these Terms and Conditions to use our trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under the Apache License, Version 2.0 that is effective on the second anniversary of the date we make the Software available. On or after that date, you may use the Software under the Apache License, Version 2.0, in which case the following will apply:
+
+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.

package/README.md

@@ -0,0 +1,3 @@
+# Service Library
+
+A library containing base definitions for interacting with Micro services.

package/dist/alerts/alerts-index.d.ts

@@ -0,0 +1,2 @@
+export * from './definitions.js';
+export * from './no-op-reporter.js';

package/dist/alerts/alerts-index.js

@@ -0,0 +1,3 @@
+export * from './definitions.js';
+export * from './no-op-reporter.js';
+//# sourceMappingURL=alerts-index.js.map

package/dist/alerts/alerts-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-index.js","sourceRoot":"","sources":["../../src/alerts/alerts-index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/alerts/definitions.d.ts

@@ -0,0 +1,13 @@
+import * as errors from '../errors/errors-index.js';
+export type Primitive = string | number | boolean;
+export type CaptureOptions = {
+    level?: errors.ErrorSeverity;
+    tags?: Record<string, Primitive | undefined>;
+    metadata?: Record<string, Primitive | undefined>;
+};
+export type CaptureErrorFunction = (error: any, options?: CaptureOptions) => void;
+export type CaptureMessageFunction = (message: string, options?: CaptureOptions) => void;
+export type ErrorReporter = {
+    captureException: CaptureErrorFunction;
+    captureMessage: CaptureMessageFunction;
+};

package/dist/alerts/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/alerts/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/alerts/definitions.ts"],"names":[],"mappings":""}

package/dist/alerts/no-op-reporter.d.ts

@@ -0,0 +1,2 @@
+import { ErrorReporter } from './definitions.js';
+export declare const NoOpReporter: ErrorReporter;

package/dist/alerts/no-op-reporter.js

@@ -0,0 +1,5 @@
+export const NoOpReporter = {
+    captureException: () => { },
+    captureMessage: () => { }
+};
+//# sourceMappingURL=no-op-reporter.js.map

package/dist/alerts/no-op-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-op-reporter.js","sourceRoot":"","sources":["../../src/alerts/no-op-reporter.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,gBAAgB,EAAE,GAAG,EAAE,GAAE,CAAC;IAC1B,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;CACzB,CAAC"}

package/dist/codec/codec-index.d.ts

@@ -0,0 +1,2 @@
+export * from './codecs.js';
+export * from './parsers.js';

package/dist/codec/codec-index.js

@@ -0,0 +1,3 @@
+export * from './codecs.js';
+export * from './parsers.js';
+//# sourceMappingURL=codec-index.js.map

package/dist/codec/codec-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-index.js","sourceRoot":"","sources":["../../src/codec/codec-index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/codec/codecs.d.ts

@@ -0,0 +1,26 @@
+/// <reference types="node" resolution-mode="require"/>
+import * as t from 'ts-codec';
+import * as bson from 'bson';
+export declare const buffer: t.Codec<Buffer, string, string, t.CodecProps>;
+export declare const date: t.Codec<Date, string, string, t.CodecProps>;
+export declare const ObjectId: t.Codec<bson.ObjectId, string, string, t.CodecProps>;
+export declare const ResourceId: t.Codec<{
+    _id: bson.ObjectId;
+}, {
+    id: string;
+}, string, t.CodecProps>;
+export declare const Timestamps: t.ObjectCodec<{
+    created_at: t.Codec<Date, string, string, t.CodecProps>;
+    updated_at: t.Codec<Date, string, string, t.CodecProps>;
+}>;
+export declare const Resource: t.Intersection<t.Codec<{
+    _id: bson.ObjectId;
+}, {
+    id: string;
+}, string, t.CodecProps>, t.ObjectCodec<{
+    created_at: t.Codec<Date, string, string, t.CodecProps>;
+    updated_at: t.Codec<Date, string, string, t.CodecProps>;
+}>>;
+export declare const QueryFilter: t.ObjectCodec<{
+    exists: t.IdentityCodec<t.CodecType.Boolean>;
+}>;

package/dist/codec/codecs.js

@@ -0,0 +1,60 @@
+import * as t from 'ts-codec';
+import * as bson from 'bson';
+export const buffer = t.codec('Buffer', (buffer) => {
+    if (!Buffer.isBuffer(buffer)) {
+        throw new t.TransformError([`Expected buffer but got ${typeof buffer}`]);
+    }
+    return buffer.toString('base64');
+}, (buffer) => Buffer.from(buffer, 'base64'));
+export const date = t.codec('Date', (date) => {
+    if (!(date instanceof Date)) {
+        throw new t.TransformError([`Expected Date but got ${typeof date}`]);
+    }
+    return date.toISOString();
+}, (date) => {
+    const parsed = new Date(date);
+    if (isNaN(parsed.getTime())) {
+        throw new t.TransformError([`Invalid date`]);
+    }
+    return parsed;
+});
+const assertObjectId = (value) => {
+    if (!bson.ObjectId.isValid(value)) {
+        throw new t.TransformError([`Expected an ObjectId but got ${typeof value}`]);
+    }
+};
+export const ObjectId = t.codec('ObjectId', (id) => {
+    assertObjectId(id);
+    return id.toHexString();
+}, (id) => {
+    assertObjectId(id);
+    return new bson.ObjectId(id);
+});
+const assertObjectWithField = (field, data) => {
+    if (typeof data !== 'object') {
+        throw new t.TransformError([`Expected an object but got ${typeof data}`]);
+    }
+    if (!(field in data)) {
+        throw new t.TransformError([`Expected ${field} to be a member of object`]);
+    }
+};
+export const ResourceId = t.codec('ResourceId', (data) => {
+    assertObjectWithField('_id', data);
+    return {
+        id: ObjectId.encode(data._id)
+    };
+}, (data) => {
+    assertObjectWithField('id', data);
+    return {
+        _id: ObjectId.decode(data.id)
+    };
+});
+export const Timestamps = t.object({
+    created_at: date,
+    updated_at: date
+});
+export const Resource = ResourceId.and(Timestamps);
+export const QueryFilter = t.object({
+    exists: t.boolean
+});
+//# sourceMappingURL=codecs.js.map

package/dist/codec/codecs.js.map

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

package/dist/codec/parsers.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="node" resolution-mode="require"/>
+import * as t from 'ts-codec';
+export declare const ObjectIdParser: t.Parser<string, t.Codec<import("bson").ObjectId, string, string, t.CodecProps>>;
+export declare const ResourceIdParser: t.Parser<string, t.Codec<{
+    _id: import("bson").ObjectId;
+}, {
+    id: string;
+}, string, t.CodecProps>>;
+export declare const DateParser: t.Parser<string, t.Codec<Date, string, string, t.CodecProps>>;
+export declare const BufferParser: t.Parser<string, t.Codec<Buffer, string, string, t.CodecProps>>;
+export declare const parsers: (t.Parser<string, t.Codec<import("bson").ObjectId, string, string, t.CodecProps>> | t.Parser<string, t.Codec<{
+    _id: import("bson").ObjectId;
+}, {
+    id: string;
+}, string, t.CodecProps>> | t.Parser<string, t.Codec<Date, string, string, t.CodecProps>> | t.Parser<string, t.Codec<Buffer, string, string, t.CodecProps>>)[];

package/dist/codec/parsers.js

@@ -0,0 +1,56 @@
+import * as t from 'ts-codec';
+import * as codecs from './codecs.js';
+export const ObjectIdParser = t.createParser(codecs.ObjectId._tag, (_, { target }) => {
+    switch (target) {
+        case t.TransformTarget.Encoded: {
+            return { type: 'string' };
+        }
+        case t.TransformTarget.Decoded: {
+            return { bsonType: 'ObjectId' };
+        }
+    }
+});
+export const ResourceIdParser = t.createParser(codecs.ResourceId._tag, (_, { target }) => {
+    switch (target) {
+        case t.TransformTarget.Encoded: {
+            return {
+                type: 'object',
+                properties: {
+                    id: { type: 'string' }
+                },
+                required: ['id']
+            };
+        }
+        case t.TransformTarget.Decoded: {
+            return {
+                type: 'object',
+                properties: {
+                    _id: { bsonType: 'ObjectId' }
+                },
+                required: ['_id']
+            };
+        }
+    }
+});
+export const DateParser = t.createParser(codecs.date._tag, (_, { target }) => {
+    switch (target) {
+        case t.TransformTarget.Encoded: {
+            return { type: 'string' };
+        }
+        case t.TransformTarget.Decoded: {
+            return { nodeType: 'date' };
+        }
+    }
+});
+export const BufferParser = t.createParser(codecs.buffer._tag, (_, { target }) => {
+    switch (target) {
+        case t.TransformTarget.Encoded: {
+            return { type: 'string' };
+        }
+        case t.TransformTarget.Decoded: {
+            return { nodeType: 'buffer' };
+        }
+    }
+});
+export const parsers = [ObjectIdParser, ResourceIdParser, DateParser, BufferParser];
+//# sourceMappingURL=parsers.js.map

package/dist/codec/parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../../src/codec/parsers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,YAAY,CAAyB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IAC3G,QAAQ,MAAM,EAAE;QACd,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC3B;QACD,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;SACjC;KACF;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,YAAY,CAA2B,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACjH,QAAQ,MAAM,EAAE;QACd,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACvB;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;aACjB,CAAC;SACH;QACD,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,GAAG,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE;iBAC9B;gBACD,QAAQ,EAAE,CAAC,KAAK,CAAC;aAClB,CAAC;SACH;KACF;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAqB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IAC/F,QAAQ,MAAM,EAAE;QACd,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC3B;QACD,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;SAC7B;KACF;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAuB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACrG,QAAQ,MAAM,EAAE;QACd,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC3B;QACD,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;SAC/B;KACF;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC"}

package/dist/container.d.ts

@@ -0,0 +1,48 @@
+import { ErrorReporter } from './alerts/definitions.js';
+import { ProbeModule, TerminationHandler } from './signals/signals-index.js';
+export declare enum ContainerImplementation {
+    REPORTER = "reporter",
+    PROBES = "probes",
+    TERMINATION_HANDLER = "termination-handler"
+}
+export type ContainerImplementationTypes = {
+    [ContainerImplementation.REPORTER]: ErrorReporter;
+    [ContainerImplementation.PROBES]: ProbeModule;
+    [ContainerImplementation.TERMINATION_HANDLER]: TerminationHandler;
+};
+export type RegisterDefaultsOptions = {
+    skip?: ContainerImplementation[];
+};
+export type ContainerImplementationDefaultGenerators = {
+    [type in ContainerImplementation]: () => ContainerImplementationTypes[type];
+};
+export declare class Container {
+    protected implementations: Partial<ContainerImplementationTypes>;
+    /**
+     * Manager for system health probes
+     */
+    get probes(): ProbeModule;
+    /**
+     * Error reporter. Defaults to a no-op reporter
+     */
+    get reporter(): ErrorReporter;
+    /**
+     * Handler for termination of the Node process
+     */
+    get terminationHandler(): {
+        handleTerminationSignal: (handler: import("./signals/termination-handler.js").Handler) => void;
+        handleTerminationSignalLast: (handler: import("./signals/termination-handler.js").Handler) => void;
+        gracefully: <T>(exec: () => T | Promise<T>, handler: (component: T, signal: import("./signals/termination-handler.js").Signal) => void | Promise<void>) => Promise<T>;
+    };
+    constructor();
+    getImplementation<Type extends ContainerImplementation>(type: Type): NonNullable<Partial<ContainerImplementationTypes>[Type]>;
+    /**
+     * Registers default implementations
+     */
+    registerDefaults(options?: RegisterDefaultsOptions): void;
+    /**
+     * Allows for overriding a default implementation
+     */
+    register<Type extends ContainerImplementation>(type: Type, implementation: ContainerImplementationTypes[Type]): void;
+}
+export declare const container: Container;

package/dist/container.js

@@ -0,0 +1,61 @@
+import _ from 'lodash';
+import { NoOpReporter } from './alerts/no-op-reporter.js';
+import { createFSProbe, createTerminationHandler } from './signals/signals-index.js';
+export var ContainerImplementation;
+(function (ContainerImplementation) {
+    ContainerImplementation["REPORTER"] = "reporter";
+    ContainerImplementation["PROBES"] = "probes";
+    ContainerImplementation["TERMINATION_HANDLER"] = "termination-handler";
+})(ContainerImplementation || (ContainerImplementation = {}));
+const DEFAULT_GENERATORS = {
+    [ContainerImplementation.REPORTER]: () => NoOpReporter,
+    [ContainerImplementation.PROBES]: () => createFSProbe(),
+    [ContainerImplementation.TERMINATION_HANDLER]: () => createTerminationHandler()
+};
+export class Container {
+    /**
+     * Manager for system health probes
+     */
+    get probes() {
+        return this.getImplementation(ContainerImplementation.PROBES);
+    }
+    /**
+     * Error reporter. Defaults to a no-op reporter
+     */
+    get reporter() {
+        return this.getImplementation(ContainerImplementation.REPORTER);
+    }
+    /**
+     * Handler for termination of the Node process
+     */
+    get terminationHandler() {
+        return this.getImplementation(ContainerImplementation.TERMINATION_HANDLER);
+    }
+    constructor() {
+        this.implementations = {};
+    }
+    getImplementation(type) {
+        const implementation = this.implementations[type];
+        if (!implementation) {
+            throw new Error(`Implementation for ${type} has not been registered.`);
+        }
+        return implementation;
+    }
+    /**
+     * Registers default implementations
+     */
+    registerDefaults(options) {
+        _.difference(Object.values(ContainerImplementation), options?.skip ?? []).forEach((type) => {
+            const generator = DEFAULT_GENERATORS[type];
+            this.implementations[type] = generator(); // :(
+        });
+    }
+    /**
+     * Allows for overriding a default implementation
+     */
+    register(type, implementation) {
+        this.implementations[type] = implementation;
+    }
+}
+export const container = new Container();
+//# sourceMappingURL=container.js.map

package/dist/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAmC,aAAa,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtH,MAAM,CAAN,IAAY,uBAIX;AAJD,WAAY,uBAAuB;IACjC,gDAAqB,CAAA;IACrB,4CAAiB,CAAA;IACjB,sEAA2C,CAAA;AAC7C,CAAC,EAJW,uBAAuB,KAAvB,uBAAuB,QAIlC;AAgBD,MAAM,kBAAkB,GAA6C;IACnE,CAAC,uBAAuB,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,YAAY;IACtD,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE;IACvD,CAAC,uBAAuB,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,CAAC,wBAAwB,EAAE;CAChF,CAAC;AAEF,MAAM,OAAO,SAAS;IAGpB;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,mBAAmB,CAAC,CAAC;IAC7E,CAAC;IAED;QACE,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED,iBAAiB,CAAuC,IAAU;QAChE,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,cAAc,EAAE;YACnB,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,2BAA2B,CAAC,CAAC;SACxE;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAAiC;QAChD,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACzF,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,SAAS,EAAS,CAAC,CAAC,KAAK;QACxD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ,CAAuC,IAAU,EAAE,cAAkD;QAC3G,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC"}

package/dist/errors/errors-index.d.ts

@@ -0,0 +1,2 @@
+export * from './framework-errors.js';
+export * from './utils.js';

package/dist/errors/errors-index.js

@@ -0,0 +1,3 @@
+export * from './framework-errors.js';
+export * from './utils.js';
+//# sourceMappingURL=errors-index.js.map

package/dist/errors/errors-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-index.js","sourceRoot":"","sources":["../../src/errors/errors-index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC"}

package/dist/errors/framework-errors.d.ts

@@ -0,0 +1,50 @@
+export declare enum ErrorSeverity {
+    INFO = "info",
+    WARNING = "warning",
+    ERROR = "error"
+}
+export type ErrorData = {
+    name?: string;
+    code: string;
+    description: string;
+    severity?: ErrorSeverity;
+    details?: string;
+    status?: number;
+    stack?: string;
+    origin?: string;
+    trace_id?: string;
+};
+export declare class JourneyError extends Error {
+    is_journey_error: boolean;
+    errorData: ErrorData;
+    static isJourneyError(input: any): input is JourneyError;
+    constructor(data: ErrorData);
+    toString(): string | undefined;
+    toJSON(): ErrorData;
+    setTraceId(id: string): void;
+}
+export declare class ValidationError extends JourneyError {
+    static CODE: string;
+    constructor(errors: any);
+}
+export declare class AuthorizationError extends JourneyError {
+    static CODE: string;
+    constructor(errors: any);
+}
+export declare class InternalServerError extends JourneyError {
+    static CODE: string;
+    constructor(err: Error);
+}
+export declare class ResourceNotFound extends JourneyError {
+    static CODE: string;
+    /**
+     * @deprecated Use the (resource, id) constructor instead.
+     * @param id
+     */
+    constructor(id: string);
+    constructor(resource: string, id: string);
+}
+export declare class ResourceConflict extends JourneyError {
+    static CODE: string;
+    constructor(details: string);
+}

package/dist/errors/framework-errors.js

@@ -0,0 +1,104 @@
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["INFO"] = "info";
+    ErrorSeverity["WARNING"] = "warning";
+    ErrorSeverity["ERROR"] = "error";
+})(ErrorSeverity || (ErrorSeverity = {}));
+// Maybe this could be renamed to ServiceError or something similar
+export class JourneyError extends Error {
+    static isJourneyError(input) {
+        return input instanceof JourneyError || input?.is_journey_error == true;
+    }
+    constructor(data) {
+        super(`[${data.code}] ${data.description}\n  ${data.details}`);
+        this.is_journey_error = true;
+        this.errorData = data;
+        if (data.stack) {
+            this.stack = data.stack;
+        }
+        this.name = data.name || this.constructor.name;
+        this.errorData.name = this.name;
+    }
+    toString() {
+        return this.stack;
+    }
+    toJSON() {
+        if (process.env.NODE_ENV !== 'production') {
+            return this.errorData;
+        }
+        return {
+            name: this.errorData.name,
+            code: this.errorData.code,
+            status: this.errorData.status,
+            description: this.errorData.description,
+            details: this.errorData.details,
+            trace_id: this.errorData.trace_id,
+            severity: this.errorData.severity,
+            origin: this.errorData.origin
+        };
+    }
+    setTraceId(id) {
+        this.errorData.trace_id = id;
+    }
+}
+export class ValidationError extends JourneyError {
+    constructor(errors) {
+        super({
+            code: ValidationError.CODE,
+            status: 400,
+            description: 'Validation failed',
+            details: JSON.stringify(errors)
+        });
+    }
+}
+ValidationError.CODE = 'VALIDATION_ERROR';
+export class AuthorizationError extends JourneyError {
+    constructor(errors) {
+        super({
+            code: AuthorizationError.CODE,
+            status: 401,
+            description: 'Authorization failed',
+            details: errors
+        });
+    }
+}
+AuthorizationError.CODE = 'AUTHORIZATION';
+export class InternalServerError extends JourneyError {
+    constructor(err) {
+        super({
+            code: InternalServerError.CODE,
+            severity: ErrorSeverity.ERROR,
+            status: 500,
+            description: 'Something went wrong',
+            details: err.message,
+            stack: process.env.NODE_ENV !== 'production' ? err.stack : undefined
+        });
+    }
+}
+InternalServerError.CODE = 'INTERNAL_SERVER_ERROR';
+export class ResourceNotFound extends JourneyError {
+    constructor(resource, id) {
+        const combinedId = id ? `${resource}/${id}` : resource;
+        super({
+            code: ResourceNotFound.CODE,
+            status: 404,
+            description: 'The requested resource does not exist on this server',
+            details: `The resource ${combinedId} does not exist on this server`,
+            severity: ErrorSeverity.INFO
+        });
+    }
+}
+ResourceNotFound.CODE = 'RESOURCE_NOT_FOUND';
+export class ResourceConflict extends JourneyError {
+    constructor(details) {
+        super({
+            code: ResourceConflict.CODE,
+            status: 409,
+            description: 'The specified resource already exists on this server',
+            details: details,
+            severity: ErrorSeverity.INFO
+        });
+    }
+}
+ResourceConflict.CODE = 'RESOURCE_CONFLICT';
+//# sourceMappingURL=framework-errors.js.map

package/dist/errors/framework-errors.js.map

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

package/dist/errors/utils.d.ts

@@ -0,0 +1,4 @@
+import { ErrorData, JourneyError } from './framework-errors.js';
+export declare const isJourneyError: (err: any) => err is JourneyError;
+export declare const getErrorData: (err: Error | any) => ErrorData | undefined;
+export declare const matchesErrorCode: (err: Error | any, code: string) => boolean;

package/dist/errors/utils.js

@@ -0,0 +1,18 @@
+import { JourneyError } from './framework-errors.js';
+export const isJourneyError = (err) => {
+    const matches = JourneyError.isJourneyError(err);
+    return !!matches;
+};
+export const getErrorData = (err) => {
+    if (!isJourneyError(err)) {
+        return;
+    }
+    return err.toJSON();
+};
+export const matchesErrorCode = (err, code) => {
+    if (isJourneyError(err)) {
+        return err.errorData.code === code;
+    }
+    return false;
+};
+//# sourceMappingURL=utils.js.map

package/dist/errors/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/errors/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAQ,EAAuB,EAAE;IAC9D,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO,CAAC,CAAC,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAgB,EAAyB,EAAE;IACtE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE;QACxB,OAAO;KACR;IACD,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAgB,EAAE,IAAY,EAAE,EAAE;IACjE,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE;QACvB,OAAO,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC;KACpC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * from './alerts/alerts-index.js';
+export * as alerts from './alerts/alerts-index.js';
+export * from './codec/codec-index.js';
+export * as codecs from './codec/codec-index.js';
+export * from './container.js';
+export * from './errors/errors-index.js';
+export * as errors from './errors/errors-index.js';
+export * from './logger/Logger.js';
+export * from './schema/schema-index.js';
+export * as schema from './schema/schema-index.js';
+export * from './signals/signals-index.js';
+export * as signals from './signals/signals-index.js';
+export * from './router/router-index.js';
+export * as router from './router/router-index.js';
+export * from './system/LifeCycledSystem.js';
+export * as system from './system/system-index.js';
+export * from './utils/utils-index.js';
+export * as utils from './utils/utils-index.js';