core

Core

Contains some general purpose services

LocalStorage

If the browser does not support LocalStorage, we silently fall back to an in-memory storage (this is basically the case when the user prohibits access to the LS). to check whether the LocalStorage is actually available, you can read the LocalStorageService.persistent property.

Setup

To use the LocalStorage Service, you need to provide it in your bootstrapApplication call or your AppModule.

import { provideLocalStorage } from '@shiftcode/ngx-core'

bootstrapApplication(AppComponent, {
  providers: [
    provideLocalStorage({ prefix: 'APP.' }),
  ],
})

ClientId Service

The ClientId Service is used to generate a unique id for the current user.
It uses the LocalStorage Service to store the id.

The property ClientIdService.createdInThisSession exposes whether the clientId was created in this session or read from the LocalStorage.

Logger

Setup

To use the logger, you need to provide at least one LogTransport.

import { LogLevel, provideLogger, withBrowserConsoleTransport } from '@shiftcode/ngx-core'

bootstrapApplication(AppComponent, {
  providers: [
    provideLogger(
      withBrowserConsoleTransport({ logLevel: stageInfo.isProd ? LogLevel.OFF : LogLevel.DEBUG }),
    ),
  ],
})

Usage

Inside your Component/Service/... inject the LoggerService and create a logger instance.

import { Directive, inject } from '@angular/core'
import { Logger, LoggerService } from '@shiftcode/ngx-core'

@Directive({ ... })
class MyDirective {
  private readonly logger: Logger = inject(LoggerService).getInstance('MyDirective')

  doSomething() {
    this.logger.debug('doing something')
  }
}

Provided LogTransports

• Browser Console: withBrowserConsoleTransport(...)
• Node Console: withNodeConsoleTransport(...)
• Remote: withRemoteTransport(...)
• AWS CloudFront: see @shiftcode/ngx-aws