feat(ssr): adds SSR support

[pavankjadda]

This PR creates new project ngx-cookie-service-ssr that adds support for SSR. So far 1 beta version and one rc version released with this PR changes and that can be seen here: https://www.npmjs.com/package/ngx-cookie-service-ssr

Here is the summary of the approach

• When express server loads web page, it does have cookies in request object, but since our cookie service depends on document object we can't access them
• To fix this, first we need to provide REQUEST in providers. We can achieve this by modifying server.ts file

...............

  server.get('*', (req, res) => {
    res.render(indexHtml, {
      req, providers: [
        {provide: APP_BASE_HREF, useValue: req.baseUrl},
        {provide: 'REQUEST', useValue: (req)},
        {provide: 'RESPONSE', useValue: (res)}]
    });
  });
  return server;
};

...............

• Then we need to inject REQUEST object in cookie service, which helps us to get cookies on server side through REQUEST

import {REQUEST} from '@nguniversal/express-engine/tokens';

@Injectable()
export class CookieService {
constructor(@Optional() @Inject(REQUEST) private request: Request) {
  }

• Then we need provide this in AppServerModule

@NgModule({
  imports: [
    AppModule,
    ServerModule,
  ],
  bootstrap: [AppComponent],
  providers: [CookieService]
})
export class AppServerModule {
}

• Finally, if the platform is server, we can get the cookies in the following way, otherwise we can use existing method

const result: RegExpExecArray = regExp.exec(this.isServer ? this.request?.headers.get('cookie') : this.document.cookie);

Closes #225. Sample project can be found here https://github.com/pavankjadda/angular-ssr-docker

[github-actions]

Hello 👋 @pavankjadda
Thank you for raising your pull request. Please make sure you have followed our contributing guidelines. We will review it as soon as possible.

[pavankjadda]

I released one beta version and one rc version for this project and it's present in https://www.npmjs.com/package/ngx-cookie-service-ssr

[stevermeister]

nice!

[stevermeister]

so basically instead of all conditional dependencies - you duplicate the service?

maybe not such a bad idea - to make it explicit

[pavankjadda]

Yeah. The other open I see is create a utility class/function that has common functionality and make both client/ssr cookie service use it. What do think about that?

My suggestion is we use this as it for now and think about optimization later.

[stevermeister]

yes, I think that's a really good idea, instead of over-engineering, simple solution that just works!

[pavankjadda]

@stevermeister I think we can merge this and release first SSR version. Based on user feed back, if needed we can change it. Thoughts?

[stevermeister]

👍

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
2 Code Smells

No Coverage information
2.5% Duplication