@privateaim/server-kit 0.8.13 → 0.8.15

package/dist/services/log-store/types.d.ts

@@ -0,0 +1,27 @@
+import type { Log, LogLevel } from '@privateaim/kit';
+export type LogStoreQueryOptions = {
+    labels?: Record<string, string>;
+    start?: number;
+    end?: number;
+    sort?: 'DESC' | 'ASC';
+    limit?: number;
+};
+export type LogStoreDeleteOptions = {
+    labels?: Record<string, string>;
+    start?: number;
+    end?: number;
+};
+export type LogInput = Omit<Log, 'labels' | 'time' | 'level'> & {
+    time?: bigint;
+    level?: `${LogLevel}`;
+    labels?: Record<string, string>;
+};
+export interface LogStore {
+    setLabels(labels: Record<string, string>): void;
+    getLabels(): Record<string, string>;
+    extendLabels(labels: Record<string, string>): void;
+    write(message: string | LogInput, labels?: Record<string, string>): Promise<Log>;
+    query(options?: LogStoreQueryOptions): Promise<[Log[], number]>;
+    delete(options?: LogStoreDeleteOptions): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/log-store/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/log-store/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC,CAAC;AAEF,MAAM,WAAW,QAAQ;IACrB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAEhD,SAAS,IAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAEnD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IAElF,KAAK,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAEjE,MAAM,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D"}

package/dist/services/logger/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/services/logger/module.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,KAAK,EAAE,mBAAmB,EAAoB,MAAM,SAAS,CAAC;AAErE,wBAAgB,YAAY,CAAC,GAAG,GAAE,mBAAwB,GAAI,MAAM,CA0CnE"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/services/logger/module.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,KAAK,EAAE,mBAAmB,EAAoB,MAAM,SAAS,CAAC;AAIrE,wBAAgB,YAAY,CAAC,GAAG,GAAE,mBAAwB,GAAI,MAAM,CAuDnE"}

package/dist/services/logger/store.d.ts

@@ -0,0 +1,14 @@
+import type { TransportStreamOptions } from 'winston-transport';
+import WinstonTransport from 'winston-transport';
+import type { LogStore } from '../log-store';
+type LogStoreTransportOptions = TransportStreamOptions & {
+    labels?: Record<string, string>;
+};
+export declare class LogStoreTransport extends WinstonTransport {
+    protected instance: LogStore;
+    protected labels: Record<string, string>;
+    constructor(store: LogStore, options?: LogStoreTransportOptions);
+    log(info: Record<PropertyKey, any>, next: () => void): any;
+}
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/services/logger/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/services/logger/store.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,gBAAgB,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEvD,KAAK,wBAAwB,GAAG,sBAAsB,GAAG;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,gBAAgB;IACnD,SAAS,CAAC,QAAQ,EAAG,QAAQ,CAAC;IAE9B,SAAS,CAAC,MAAM,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAE9B,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,wBAA6B;IAOnE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,GAAG;CA0C7D"}

package/dist/services/logger/types.d.ts

@@ -1,7 +1,10 @@
 import type { Logger, LoggerOptions } from 'winston';
+import type { LogStore } from '../log-store';
 export type LoggerCreateContext = {
     directory?: string;
     options?: Partial<LoggerOptions>;
+    store?: LogStore;
+    labels?: Record<string, string>;
 };
 export type LoggerTransports = LoggerOptions['transports'];
 export type { Logger, };

package/dist/services/logger/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/logger/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;CACnC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;AAE3D,YAAY,EACR,MAAM,GACT,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/logger/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAAG;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;AAE3D,YAAY,EACR,MAAM,GACT,CAAC"}

package/dist/services/loki/index.d.ts

@@ -0,0 +1,3 @@
+export * from './module';
+export * from './singleton';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/loki/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/loki/index.ts"],"names":[],"mappings":"AAOA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/services/loki/module.d.ts

@@ -0,0 +1,3 @@
+import { LokiClient, CompactorDeletionRequestCreate as LokiCompactorDeletionRequestCreate, Config as LokiConfig, ConfigInput as LokiConfigInput, DistributorPushStream as LokiDistributorPushStream, QuerierQueryRangeOptions as LokiQuerierQueryRangeOptions, QuerierQueryResult as LokiQuerierQueryResult, createClient as createLokiClient, nanoSeconds } from '@hapic/loki';
+export { LokiClient, LokiConfig, LokiConfigInput, LokiCompactorDeletionRequestCreate, LokiDistributorPushStream, LokiQuerierQueryRangeOptions, LokiQuerierQueryResult, createLokiClient, nanoSeconds, };
+//# sourceMappingURL=module.d.ts.map

package/dist/services/loki/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/services/loki/module.ts"],"names":[],"mappings":"AAOA,OAAO,EACH,UAAU,EACV,8BAA8B,IAAI,kCAAkC,EACpE,MAAM,IAAI,UAAU,EACpB,WAAW,IAAI,eAAe,EAC9B,qBAAqB,IAAI,yBAAyB,EAClD,wBAAwB,IAAI,4BAA4B,EACxD,kBAAkB,IAAI,sBAAsB,EAC5C,YAAY,IAAI,gBAAgB,EAChC,WAAW,EACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,UAAU,EACV,UAAU,EACV,eAAe,EACf,kCAAkC,EAClC,yBAAyB,EACzB,4BAA4B,EAC5B,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,GACd,CAAC"}

package/dist/services/loki/singleton.d.ts

@@ -0,0 +1,6 @@
+import type { Factory } from 'singa';
+import type { LokiClient } from '@hapic/loki';
+export declare function setLokiFactory(factory: Factory<LokiClient>): void;
+export declare function isLokiClientUsable(): boolean;
+export declare function useLokiClient(): LokiClient;
+//# sourceMappingURL=singleton.d.ts.map

package/dist/services/loki/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../../src/services/loki/singleton.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,QAE1D;AAED,wBAAgB,kBAAkB,YAEjC;AAED,wBAAgB,aAAa,eAE5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@privateaim/server-kit",
-    "version": "0.8.13",
+    "version": "0.8.15",
     "exports": {
         "./package.json": "./package.json",
         ".": {
@@ -28,24 +28,27 @@
     },
     "dependencies": {
         "@ebec/http": "^2.3.0",
+        "@hapic/loki": "^1.2.0",
         "@isaacs/ttlcache": "^1.4.1",
-        "@privateaim/kit": "^0.8.13",
+        "@privateaim/kit": "^0.8.15",
         "@socket.io/redis-emitter": "^5.1.0",
         "envix": "^1.5.0",
-        "hapic": "^2.5.2",
-        "singa": "^1.0.0",
-        "winston": "^3.17.0"
+        "hapic": "^2.7.0",
+        "singa": "^1.1.0",
+        "triple-beam": "^1.4.1",
+        "winston": "^3.17.0",
+        "winston-transport": "^4.9.0"
     },
     "devDependencies": {
-        "@authup/core-http-kit": "^1.0.0-beta.26",
-        "@hapic/vault": "^2.3.5",
+        "@authup/core-http-kit": "^1.0.0-beta.27",
+        "@hapic/vault": "^2.3.9",
         "amqp-extension": "^4.0.0",
         "redis-extension": "^2.0.2",
         "typeorm-extension": "^3.7.1"
     },
     "peerDependencies": {
-        "@authup/core-http-kit": "^1.0.0-beta.26",
-        "@hapic/vault": "^2.3.5",
+        "@authup/core-http-kit": "^1.0.0-beta.27",
+        "@hapic/vault": "^2.3.9",
         "amqp-extension": "^4.0.0",
         "redis-extension": "^2.0.2",
         "typeorm-extension": "^3.7.1"

package/src/services/domain-event/index.ts

@@ -9,4 +9,4 @@ export * from './module';
 export * from './redis';
 export * from './singleton';
 export * from './socket';
-export * from './type';
+export * from './types';

package/src/services/domain-event/module.ts

@@ -5,10 +5,10 @@
  * view the LICENSE file that was distributed with this source code.
  */
 
-import type { DomainEventRecord } from '@privateaim/kit';
+import type { ObjectLiteral } from '@privateaim/kit';
 import { buildDomainEventFullName } from '@privateaim/kit';
 import { isLoggerUsable, useLogger } from '../logger';
-import type { DomainEventPublishContext, IDomainEventPublisher } from './type';
+import type { DomainEventPublishOptions, IDomainEventPublisher } from './types';
 
 export class DomainEventPublisher implements IDomainEventPublisher {
     protected publishers : Set<IDomainEventPublisher>;
@@ -21,24 +21,24 @@ export class DomainEventPublisher implements IDomainEventPublisher {
         this.publishers.add(publisher);
     }
 
-    async safePublish<T extends DomainEventRecord>(
-        ctx: DomainEventPublishContext<T>,
+    async safePublish<T extends ObjectLiteral = ObjectLiteral>(
+        ctx: DomainEventPublishOptions<T>,
     ) : Promise<void> {
         try {
             await this.publish(ctx);
         } catch (e) {
             if (isLoggerUsable()) {
-                useLogger().error(`Publishing event ${buildDomainEventFullName(ctx.data.type, ctx.data.event)} failed`);
+                useLogger().error(`Publishing event ${buildDomainEventFullName(ctx.metadata.domain, ctx.metadata.event)} failed`);
                 useLogger().error(e);
             }
         }
     }
 
-    async publish<T extends DomainEventRecord>(
-        ctx: DomainEventPublishContext<T>,
+    async publish<T extends ObjectLiteral = ObjectLiteral>(
+        ctx: DomainEventPublishOptions<T>,
     ) : Promise<void> {
         if (isLoggerUsable()) {
-            useLogger().info(`Publishing event ${buildDomainEventFullName(ctx.data.type, ctx.data.event)}`);
+            useLogger().info(`Publishing event ${buildDomainEventFullName(ctx.metadata.domain, ctx.metadata.event)}`);
         }
 
         const publishers = this.publishers.values();

package/src/services/domain-event/redis/module.ts

@@ -6,7 +6,8 @@
  */
 
 import type { Client } from 'redis-extension';
-import type { DomainEventPublishContext, IDomainEventPublisher } from '../type';
+import type { DomainEventRecord } from '@privateaim/kit';
+import type { DomainEventPublishOptions, IDomainEventPublisher } from '../types';
 import { buildEventChannelName, transformEventData } from '../utils';
 
 export class DomainEventRedisPublisher implements IDomainEventPublisher {
@@ -16,19 +17,37 @@ export class DomainEventRedisPublisher implements IDomainEventPublisher {
         this.driver = client;
     }
 
-    async publish(ctx: DomainEventPublishContext) : Promise<void> {
-        const data = JSON.stringify(transformEventData(ctx.data));
+    async publish(ctx: DomainEventPublishOptions) : Promise<void> {
+        const payload : DomainEventRecord = {
+            type: ctx.metadata.domain,
+            event: ctx.metadata.event,
+            data: transformEventData(ctx.data),
+        };
+        const payloadSerialized = JSON.stringify(payload);
 
         const pipeline = this.driver.pipeline();
         for (let i = 0; i < ctx.destinations.length; i++) {
-            const keyPrefix = (ctx.destinations[i].namespace ? `${ctx.destinations[i].namespace}:` : '');
+            const destination = ctx.destinations[i];
 
-            let key = keyPrefix + buildEventChannelName(ctx.destinations[i].channel);
-            pipeline.publish(key, data);
+            let keyPrefix : string | undefined;
+            if (destination.namespace) {
+                keyPrefix = typeof destination.namespace === 'function' ?
+                    destination.namespace(ctx.data) :
+                    destination.namespace;
+            }
+
+            let key : string;
+            if (keyPrefix) {
+                key = keyPrefix + buildEventChannelName(destination.channel);
+            } else {
+                key = buildEventChannelName(destination.channel);
+            }
+
+            pipeline.publish(key, payloadSerialized);
 
-            if (typeof ctx.destinations[i].channel === 'function') {
-                key = keyPrefix + buildEventChannelName(ctx.destinations[i].channel, ctx.data.data.id);
-                pipeline.publish(key, data);
+            if (typeof destination.channel === 'function') {
+                key = keyPrefix + buildEventChannelName(destination.channel, ctx.data.id);
+                pipeline.publish(key, payloadSerialized);
             }
         }
 

package/src/services/domain-event/singleton.ts

@@ -11,7 +11,7 @@ import { DomainEventPublisher } from './module';
 import { DomainEventRedisPublisher } from './redis';
 import { DomainEventSocketPublisher } from './socket';
 
-const instance = singa<DomainEventPublisher>({
+const singaInstance = singa<DomainEventPublisher>({
     name: 'domainEventPublisher',
     factory: () => {
         const publisher = new DomainEventPublisher();
@@ -27,6 +27,10 @@ const instance = singa<DomainEventPublisher>({
     },
 });
 
+export function useDomainEventPublisherSinga() {
+    return singaInstance;
+}
+
 export function useDomainEventPublisher() {
-    return instance.use();
+    return singaInstance.use();
 }

package/src/services/domain-event/socket/module.ts

@@ -8,7 +8,7 @@
 import { buildDomainEventFullName } from '@privateaim/kit';
 import { Emitter } from '@socket.io/redis-emitter';
 import type { Client } from 'redis-extension';
-import type { DomainEventPublishContext, IDomainEventPublisher } from '../type';
+import type { DomainEventPublishOptions, IDomainEventPublisher } from '../types';
 import { buildEventChannelName, transformEventData } from '../utils';
 
 export class DomainEventSocketPublisher implements IDomainEventPublisher {
@@ -18,34 +18,45 @@ export class DomainEventSocketPublisher implements IDomainEventPublisher {
         this.client = client;
     }
 
-    async publish(ctx: DomainEventPublishContext) : Promise<void> {
+    async publish(ctx: DomainEventPublishOptions) : Promise<void> {
         ctx.data = transformEventData(ctx.data);
 
         for (let i = 0; i < ctx.destinations.length; i++) {
+            const destination = ctx.destinations[i];
+
             let namespace : string;
-            if (ctx.destinations[i].namespace) {
-                namespace = ctx.destinations[i].namespace;
+            if (destination.namespace) {
+                namespace = typeof destination.namespace === 'function' ?
+                    destination.namespace(ctx.data) :
+                    destination.namespace;
             } else {
                 namespace = '/';
             }
 
             const emitter = new Emitter(this.client, {}, namespace);
 
-            const fullEventName = buildDomainEventFullName(ctx.data.type, ctx.data.event);
+            const fullEventName = buildDomainEventFullName(
+                ctx.metadata.domain,
+                ctx.metadata.event,
+            );
 
             const rooms : string[] = [
-                buildEventChannelName(ctx.destinations[i].channel),
+                buildEventChannelName(destination.channel),
             ];
 
-            if (typeof ctx.destinations[i].channel === 'function') {
-                rooms.push(buildEventChannelName(ctx.destinations[i].channel, ctx.data.data.id));
+            if (typeof destination.channel === 'function') {
+                rooms.push(buildEventChannelName(destination.channel, ctx.data.id));
             }
 
             for (let j = 0; j < rooms.length; j++) {
                 emitter
                     .in(rooms[j])
                     .emit(fullEventName, {
-                        ...ctx.data,
+                        data: {
+                            data: ctx.data,
+                            type: ctx.metadata.domain,
+                            event: ctx.metadata.event,
+                        },
                         meta: {
                             namespace,
                             roomName: rooms[j],

package/src/services/domain-event/types.ts

@@ -0,0 +1,50 @@
+/*
+ * Copyright (c) 2022-2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import type { ObjectLiteral } from '@privateaim/kit';
+
+export type DomainEventChannelName = string | ((id?: string) => string);
+export type DomainEventNamespaceName<
+    T extends ObjectLiteral = ObjectLiteral,
+> = string | ((data: T) => string);
+
+export type DomainEventDestination<
+    T extends ObjectLiteral = ObjectLiteral,
+> = {
+    namespace?: DomainEventNamespaceName<T>,
+    channel: DomainEventChannelName
+};
+
+export type DomainEventDestinations<
+T extends ObjectLiteral =ObjectLiteral,
+> = DomainEventDestination<T>[];
+
+export type DomainEventIdentity = {
+    id?: string,
+    name?: string,
+    type?: string,
+    ipAddress?: string,
+};
+
+export type DomainEventMetadata = {
+    domain: string,
+    event: string,
+    identity?: DomainEventIdentity,
+};
+
+export type DomainEventPublishOptions<
+    T extends ObjectLiteral = ObjectLiteral,
+> = {
+    data: T,
+    dataPrevious?: T,
+    metadata: DomainEventMetadata,
+    destinations: DomainEventDestinations<T['data']>
+};
+
+export interface IDomainEventPublisher {
+    publish(ctx: DomainEventPublishOptions) : Promise<void>;
+}

package/src/services/domain-event/utils.ts

@@ -6,7 +6,7 @@
  */
 
 import { isObject } from '@privateaim/kit';
-import type { DomainEventChannelName } from './type';
+import type { DomainEventChannelName } from './types';
 
 export function transformEventData<T>(input: T) : T {
     if (isObject(input)) {
@@ -24,7 +24,7 @@ export function transformEventData<T>(input: T) : T {
 
 export function buildEventChannelName(
     input: DomainEventChannelName,
-    id?: string | number,
+    id?: string,
 ) : string {
     if (typeof input === 'string') {
         return input;

package/src/services/index.ts

@@ -10,6 +10,8 @@ export * from './authup';
 export * from './authup-client-authentication-hook';
 export * from './cache';
 export * from './domain-event';
+export * from './loki';
+export * from './log-store';
 export * from './logger';
 export * from './redis';
 export * from './vault';

package/src/services/log-store/entities/base.ts

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025.
+ *  Author Peter Placzek (tada5hi)
+ *  For the full copyright and license information,
+ *  view the LICENSE file that was distributed with this source code.
+ */
+
+export abstract class BaseLogStore {
+    protected labels: Record<string, string>;
+
+    setLabels(labels: Record<string, string>): void {
+        this.labels = labels;
+    }
+
+    getLabels() : Record<string, string> {
+        return this.labels;
+    }
+
+    extendLabels(labels: Record<string, string>): void {
+        const keys = Object.keys(labels);
+        for (let i = 0; i < keys.length; i++) {
+            this.labels[keys[i]] = labels[keys[i]];
+        }
+    }
+}

package/src/services/log-store/entities/index.ts

@@ -0,0 +1,9 @@
+/*
+ * Copyright (c) 2025.
+ *  Author Peter Placzek (tada5hi)
+ *  For the full copyright and license information,
+ *  view the LICENSE file that was distributed with this source code.
+ */
+
+export * from './loki';
+export * from './memory';

package/src/services/log-store/entities/loki.ts

@@ -0,0 +1,158 @@
+/*
+ * Copyright (c) 2025.
+ *  Author Peter Placzek (tada5hi)
+ *  For the full copyright and license information,
+ *  view the LICENSE file that was distributed with this source code.
+ */
+
+import type { Log } from '@privateaim/kit';
+import { LogLevel } from '@privateaim/kit';
+import type { LokiClient, LokiDistributorPushStream, LokiQuerierQueryRangeOptions } from '../../loki';
+import { nanoSeconds } from '../../loki';
+import type {
+    LogInput, LogStore, LogStoreDeleteOptions, LogStoreQueryOptions,
+} from '../types';
+import { BaseLogStore } from './base';
+
+export class LokiLogStore extends BaseLogStore implements LogStore {
+    protected instance : LokiClient;
+
+    constructor(instance: LokiClient, labels?: Record<string, string>) {
+        super();
+
+        this.instance = instance;
+        this.labels = labels || {};
+    }
+
+    async write(message: string | LogInput, labels?: Record<string, string>): Promise<Log> {
+        let data : Log;
+
+        if (typeof message === 'string') {
+            const labelsNormalized = {
+                ...this.labels,
+                ...(labels || {}),
+            };
+            const level = (labelsNormalized.level || LogLevel.DEBUG) as LogLevel;
+            delete labelsNormalized.level;
+
+            data = {
+                message,
+                level,
+                time: nanoSeconds(),
+                labels: labelsNormalized,
+            };
+        } else {
+            const labelsNormalized = {
+                ...this.labels,
+                ...(message.labels || {}),
+                ...(labels || {}),
+            };
+
+            const level = (message.level || labelsNormalized.level || LogLevel.DEBUG) as LogLevel;
+            delete labelsNormalized.level;
+
+            data = {
+                ...message,
+                level,
+                time: message.time || nanoSeconds(),
+                labels: labelsNormalized,
+            };
+        }
+
+        const stream : LokiDistributorPushStream = {
+            stream: data.labels,
+            values: [
+                [data.time, data.message, { level: data.level }],
+            ],
+        };
+
+        await this.instance.distributor.push(stream);
+
+        return data;
+    }
+
+    async delete(options: LogStoreDeleteOptions): Promise<void> {
+        await this.instance.compactor.createDeletionRequest({
+            start: options.start,
+            ...(options.end ? { end: options.end } : {}),
+            query: this.buildQuery({
+                ...this.labels,
+                ...(options.labels || {}),
+            }),
+        });
+    }
+
+    async query(input: LogStoreQueryOptions): Promise<[Log[], number]> {
+        const options : LokiQuerierQueryRangeOptions = {
+            query: this.buildQuery({
+                ...this.labels,
+                ...(input.labels || {}),
+            }),
+        };
+
+        if (input.sort) {
+            options.direction = input.sort === 'DESC' ? 'forward' : 'backward';
+        }
+
+        if (input.limit) {
+            options.limit = input.limit;
+        }
+
+        if (input.start) {
+            options.start = BigInt(new Date(`${input.start}`).getTime()) * 1_000_000n;
+        }
+
+        if (input.end) {
+            options.end = BigInt(new Date(`${input.end}`).getTime()) * 1_000_000n;
+        }
+
+        const output : Log[] = [];
+
+        const response = await this.instance.querier.queryRange(options);
+        if (response.data.resultType === 'streams') {
+            for (let i = 0; i < response.data.result.length; i++) {
+                const set = response.data.result[i];
+
+                const labels = set.stream;
+                let level : LogLevel;
+
+                if (labels.level) {
+                    level = labels.level as LogLevel;
+                } else {
+                    level = labels.detected_level as LogLevel;
+                }
+                delete labels.level;
+                delete labels.detected_level;
+
+                if (!labels.service) {
+                    labels.service = labels.service_name;
+                }
+                delete labels.service_name;
+
+                for (let j = 0; j < set.values.length; j++) {
+                    output.push({
+                        time: BigInt(set.values[j][0]),
+                        message: set.values[j][1],
+                        level,
+                        labels,
+                    } satisfies Log);
+                }
+            }
+        }
+
+        return [output, output.length];
+    }
+
+    // ----------------------------------------------
+
+    protected buildQuery(labels: Record<string, any>) : string {
+        const output : string[] = [];
+
+        const keys = Object.keys(labels);
+        for (let i = 0; i < keys.length; i++) {
+            output.push(`${keys[i]}="${labels[keys[i]]}"`);
+        }
+
+        return `{${output.join(',')}}`;
+    }
+}