@sneat/space-services 0.25.0 → 0.26.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/esm2022/index.js +3 -0
- package/esm2022/index.js.map +1 -1
- package/esm2022/lib/services/space-nav-service.interface.js +3 -0
- package/esm2022/lib/services/space-nav-service.interface.js.map +1 -0
- package/esm2022/lib/services/space-nav.service.js +14 -0
- package/esm2022/lib/services/space-nav.service.js.map +1 -1
- package/index.d.ts +3 -0
- package/lib/services/space-nav-service.interface.d.ts +45 -0
- package/lib/services/space-nav.service.d.ts +14 -0
- package/package.json +6 -1
- package/tsconfig.lib.prod.tsbuildinfo +1 -1
package/esm2022/index.js
CHANGED
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
export * from './lib/services/space-service.module';
|
|
2
|
+
export * from './lib/services/space-nav-service.interface';
|
|
3
|
+
/** @deprecated see the class's own JSDoc for the migration path. */
|
|
2
4
|
export * from './lib/services/space-nav.service';
|
|
3
5
|
export * from './lib/services/space.service';
|
|
4
6
|
export * from './lib/services/space-item.service';
|
|
5
7
|
export * from './lib/services/space-context.service';
|
|
6
8
|
export * from './lib/services/space-module.service';
|
|
9
|
+
/** @deprecated hard-depends on the deprecated `SpaceNavService`. */
|
|
7
10
|
export * from './lib/components/with-space-input.directive';
|
|
8
11
|
export * from './lib/guards/space-home-redirect.guard';
|
|
9
12
|
//# sourceMappingURL=index.js.map
|
package/esm2022/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/space/services/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/space/services/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,4CAA4C,CAAC;AAE3D,oEAAoE;AACpE,cAAc,kCAAkC,CAAC;AAEjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AAEpD,oEAAoE;AACpE,cAAc,6CAA6C,CAAC;AAE5D,cAAc,wCAAwC,CAAC","sourcesContent":["export * from './lib/services/space-service.module';\nexport * from './lib/services/space-nav-service.interface';\n\n/** @deprecated see the class's own JSDoc for the migration path. */\nexport * from './lib/services/space-nav.service';\n\nexport * from './lib/services/space.service';\nexport * from './lib/services/space-item.service';\nexport * from './lib/services/space-context.service';\nexport * from './lib/services/space-module.service';\n\n/** @deprecated hard-depends on the deprecated `SpaceNavService`. */\nexport * from './lib/components/with-space-input.directive';\n\nexport * from './lib/guards/space-home-redirect.guard';\n"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"space-nav-service.interface.js","sourceRoot":"","sources":["../../../../../../../libs/space/services/src/lib/services/space-nav-service.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAsE/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,cAAc,CACjD,iBAAiB,CAClB,CAAC","sourcesContent":["import { InjectionToken } from '@angular/core';\nimport { Params } from '@angular/router';\nimport { IIdAndBrief } from '@sneat/core';\nimport { IRecord } from '@sneat/data';\nimport { ISpaceDbo } from '@sneat/dto';\nimport { IMemberBrief } from '@sneat/extension-contactus-contract';\nimport { ISpaceContext } from '@sneat/space-models';\n\n/**\n * Neutral push/pop transition hint. Framework-agnostic replacement for\n * Ionic's `NavController.animationDirection`: an Ionic-backed\n * `ISpaceNavService` implementation uses it to pick `navigateRoot` vs\n * `navigateForward`; a plain-Angular `Router`-backed implementation ignores\n * it.\n */\nexport type SpaceNavDirection = 'forward' | 'back';\n\nexport interface INavigateToLoginOptions {\n readonly returnTo?: string;\n readonly queryParams?: Params;\n}\n\nexport interface ISpaceNavOptions {\n readonly queryParams?: Params;\n readonly state?: Record<string, unknown>;\n}\n\n/**\n * Semantic space-navigation contract. Implementations own the actual\n * mechanism (Ionic `NavController` nav-stack, or plain Angular `Router`) so\n * that callers and route-agnostic libraries never import a component\n * library.\n *\n * Apps provide a concrete implementation via DI — e.g.\n * `provideSpaceNavIonicInternal()` from `@sneat/space-nav-ionic` for an\n * Ionic app shell, or `provideSpaceNavRouterInternal()` from\n * `@sneat/space-nav-router` for a PrimeNG / non-Ionic app.\n */\nexport interface ISpaceNavService {\n navigateToSpaces(direction?: SpaceNavDirection): void;\n\n navigateToLogin(options?: INavigateToLoginOptions): void;\n\n navigateToUserProfile(): void;\n\n navigateToSpace(\n space: ISpaceContext,\n direction?: SpaceNavDirection,\n ): Promise<boolean>;\n\n navigateToMember(\n space: ISpaceContext,\n memberInfo: IIdAndBrief<IMemberBrief>,\n ): void;\n\n navigateToAddMetric(team: IRecord<ISpaceDbo>): void;\n\n navigateBackToSpacePage(\n space: ISpaceContext,\n page: string,\n navOptions?: ISpaceNavOptions,\n ): Promise<boolean>;\n\n navigateForwardToSpacePage(\n space: ISpaceContext,\n page: string,\n navOptions?: ISpaceNavOptions,\n ): Promise<boolean>;\n}\n\nexport const SPACE_NAV_SERVICE = new InjectionToken<ISpaceNavService>(\n 'SpaceNavService',\n);\n"]}
|
|
@@ -3,6 +3,20 @@ import { NavController } from '@ionic/angular';
|
|
|
3
3
|
import { AnalyticsService } from '@sneat/core';
|
|
4
4
|
import { ErrorLogger } from '@sneat/core';
|
|
5
5
|
import * as i0 from "@angular/core";
|
|
6
|
+
/**
|
|
7
|
+
* @deprecated Concrete, Ionic-coupled nav service. Kept for backward
|
|
8
|
+
* compatibility — a currently-published dependency of this monorepo
|
|
9
|
+
* (`@sneat/extension-contactus-shared@0.12.3`) still imports this class and
|
|
10
|
+
* `WithSpaceInput` directly from `@sneat/space-services`, so it cannot be
|
|
11
|
+
* removed from this package's public entry point without breaking that
|
|
12
|
+
* consumer; see the PR description for the full trade-off.
|
|
13
|
+
*
|
|
14
|
+
* New code should depend on `ISpaceNavService` (the `SPACE_NAV_SERVICE`
|
|
15
|
+
* injection token, also exported from this package) and have the app
|
|
16
|
+
* provide an implementation via `provideSpaceNavIonicInternal()` from
|
|
17
|
+
* `@sneat/space-nav-ionic`, or `provideSpaceNavRouterInternal()` from
|
|
18
|
+
* `@sneat/space-nav-router` for non-Ionic apps.
|
|
19
|
+
*/
|
|
6
20
|
export class SpaceNavService {
|
|
7
21
|
constructor() {
|
|
8
22
|
this.errorLogger = inject(ErrorLogger);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"space-nav.service.js","sourceRoot":"","sources":["../../../../../../../libs/space/services/src/lib/services/space-nav.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAA6C,MAAM,aAAa,CAAC;AAQ1F,OAAO,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;;
|
|
1
|
+
{"version":3,"file":"space-nav.service.js","sourceRoot":"","sources":["../../../../../../../libs/space/services/src/lib/services/space-nav.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAA6C,MAAM,aAAa,CAAC;AAQ1F,OAAO,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;;AAKxD;;;;;;;;;;;;;GAaG;AAIH,MAAM,OAAO,eAAe;IAH5B;QAImB,gBAAW,GAAG,MAAM,CAAe,WAAW,CAAC,CAAC;QAChD,kBAAa,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QACtC,qBAAgB,GAC/B,MAAM,CAAoB,gBAAgB,CAAC,CAAC;QAiFvC,wBAAmB,GAAG,CAC3B,aAA4B,EAC5B,IAAwB,EAClB,EAAE,CACR,IAAI,CAAC,cAAc,CACjB,aAAa,EACb,IAAI,EACJ,YAAY,EACZ,qBAAqB,CACtB,CAAC;QA8CI,mBAAc,GAAG,CACvB,aAA4B,EAC5B,KAAgB,EAChB,GAAW,EACX,SAAiB,EACjB,MAAgC,EAC1B,EAAE;YACR,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,UAAU,CACb,aAAa,EACb,GAAG,EACH,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,CAC1C,CAAC;QACJ,CAAC,CAAC;KACH;IArJQ,gBAAgB,CAAC,kBAAuC;QAC7D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa;aACf,YAAY,CAAC,QAAQ,EAAE,EAAE,kBAAkB,EAAE,CAAC;aAC9C,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACb,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,kCAAkC,CAAC,CACnE,CAAC;IACN,CAAC;IAEM,eAAe,CAAC,OAItB;QAEC,yDAAyD;QACzD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QAElD,MAAM,UAAU,GAAsB;YACpC,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,kBAAkB,EAAE,MAAM;SAC3B,CAAC;QACF,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtB,UAAU,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,aAAa;aACf,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC;aACjC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACb,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,kCAAkC,CAAC,CACnE,CAAC;IACN,CAAC;IAEM,qBAAqB;QAC1B,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;QACxD,IAAI,CAAC,aAAa;aACf,YAAY,CAAC,cAAc,CAAC;aAC5B,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACb,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,mCAAmC,CAAC,CACpE,CAAC;IACN,CAAC;IAEM,eAAe,CACpB,KAAoB,EACpB,kBAAuC;QAEvC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACzE,MAAM,GAAG,GAAG,SAAS,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;QACnE,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,IAAI,CAAC,aAAa;iBACf,YAAY,CAAC,GAAG,EAAE;gBACjB,KAAK,EAAE,EAAE,KAAK,EAAE;gBAChB,kBAAkB;aACnB,CAAC;iBACD,IAAI,CAAC,OAAO,CAAC;iBACb,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACb,IAAI,CAAC,WAAW,CAAC,QAAQ,CACvB,GAAG,EACH,qDAAqD,GAAG,GAAG,CAC5D,CAAC;gBACF,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,gBAAgB,CACrB,KAAoB,EACpB,UAAqC;QAErC,MAAM,EAAE,GAAG,GAAG,KAAK,CAAC,EAAE,IAAI,UAAU,CAAC,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,CACb,IAAI,CAAC,aAAa,EAClB,QAAQ,EACR;YACE,WAAW,EAAE,EAAE,EAAE,EAAE;YACnB,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;SAC7B,CACF,CAAC;IACJ,CAAC;IAaM,uBAAuB,CAC5B,KAAoB,EACpB,IAAY,EACZ,aAAgC,EAAE;QAElC,UAAU,CAAC,kBAAkB,GAAG,MAAM,CAAC;QACvC,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC;IAEM,0BAA0B,CAC/B,KAAoB,EACpB,IAAY,EACZ,aAAgC,EAAE;QAElC,UAAU,CAAC,kBAAkB,GAAG,SAAS,CAAC;QAC1C,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC;IAEO,mBAAmB,CACzB,KAAoB,EACpB,IAAY,EACZ,UAA6B;QAE7B,MAAM,GAAG,GAAG,SAAS,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;QACrC,UAAU,GAAG,EAAE,GAAG,UAAU,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC7D,CAAC;IAEO,UAAU,CAChB,aAA4B,EAC5B,GAAW,EACX,UAA6B;QAG7B,aAAa,GAAG,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC;QACpD,8EAA8E;QAC9E,aAAa;aACV,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC;aAChC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACb,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,yBAAyB,GAAG,GAAG,CAAC,CAChE,CAAC;IACN,CAAC;8GA1IU,eAAe;kHAAf,eAAe,cAFd,MAAM;;2FAEP,eAAe;kBAH3B,UAAU;mBAAC;oBACV,UAAU,EAAE,MAAM;iBACnB","sourcesContent":["import { Injectable, inject } from '@angular/core';\nimport { Params } from '@angular/router';\nimport { NavController } from '@ionic/angular';\nimport { AnalyticsService, IAnalyticsService, IIdAndBrief, ISpaceRef } from '@sneat/core';\nimport { IMemberBrief } from '@sneat/extension-contactus-contract';\n\ntype NavigationOptions = NonNullable<\n Parameters<NavController['navigateRoot']>[1]\n>;\nimport { IRecord } from '@sneat/data';\nimport { ISpaceDbo } from '@sneat/dto';\nimport { ErrorLogger, IErrorLogger } from '@sneat/core';\nimport { ISpaceContext } from '@sneat/space-models';\n\nexport type ScrumPageTab = 'team' | 'my' | 'risks' | 'qna';\n\n/**\n * @deprecated Concrete, Ionic-coupled nav service. Kept for backward\n * compatibility — a currently-published dependency of this monorepo\n * (`@sneat/extension-contactus-shared@0.12.3`) still imports this class and\n * `WithSpaceInput` directly from `@sneat/space-services`, so it cannot be\n * removed from this package's public entry point without breaking that\n * consumer; see the PR description for the full trade-off.\n *\n * New code should depend on `ISpaceNavService` (the `SPACE_NAV_SERVICE`\n * injection token, also exported from this package) and have the app\n * provide an implementation via `provideSpaceNavIonicInternal()` from\n * `@sneat/space-nav-ionic`, or `provideSpaceNavRouterInternal()` from\n * `@sneat/space-nav-router` for non-Ionic apps.\n */\n@Injectable({\n providedIn: 'root',\n})\nexport class SpaceNavService {\n private readonly errorLogger = inject<IErrorLogger>(ErrorLogger);\n private readonly navController = inject(NavController);\n private readonly analyticsService =\n inject<IAnalyticsService>(AnalyticsService);\n\n public navigateToSpaces(animationDirection?: 'forward' | 'back'): void {\n this.analyticsService.logEvent('navigateToTeams');\n this.navController\n .navigateRoot('spaces', { animationDirection })\n .catch((err) =>\n this.errorLogger.logError(err, 'Failed to navigate to teams page'),\n );\n }\n\n public navigateToLogin(options?: {\n returnTo?: string;\n queryParams?: Params;\n // fragment?: string;\n }): void {\n\n // Do not log `returnTo` as it might holds sensitive info\n this.analyticsService.logEvent('navigateToLogin');\n\n const navOptions: NavigationOptions = {\n queryParams: options?.queryParams,\n animationDirection: 'back',\n };\n if (options?.returnTo) {\n navOptions.fragment = options.returnTo;\n }\n this.navController\n .navigateRoot('login', navOptions)\n .catch((err) =>\n this.errorLogger.logError(err, 'Failed to navigate to login page'),\n );\n }\n\n public navigateToUserProfile(): void {\n this.analyticsService.logEvent('navigateToUserProfile');\n this.navController\n .navigateRoot('user-profile')\n .catch((err) =>\n this.errorLogger.logError(err, 'Failed to naviage to user profile'),\n );\n }\n\n public navigateToSpace(\n space: ISpaceContext,\n animationDirection?: 'forward' | 'back',\n ): Promise<boolean> {\n this.analyticsService.logEvent('navigateToSpace', { spaceID: space.id });\n const url = `space/${space.type || space.brief?.type}/${space.id}`;\n return new Promise<boolean>((resolve, reject) => {\n this.navController\n .navigateRoot(url, {\n state: { space },\n animationDirection,\n })\n .then(resolve)\n .catch((err) => {\n this.errorLogger.logError(\n err,\n 'Failed to navigate to team overview page with URL: ' + url,\n );\n reject(err);\n });\n });\n }\n\n public navigateToMember(\n space: ISpaceContext,\n memberInfo: IIdAndBrief<IMemberBrief>,\n ): void {\n const id = `${space.id}:${memberInfo.id}`;\n this.navForward(\n this.navController,\n 'member',\n {\n queryParams: { id },\n state: { space, memberInfo },\n },\n );\n }\n\n public navigateToAddMetric = (\n navController: NavController,\n team: IRecord<ISpaceDbo>,\n ): void =>\n this.navToSpacePage(\n navController,\n team,\n 'add-metric',\n 'navigateToAddMetric',\n );\n\n public navigateBackToSpacePage(\n space: ISpaceContext,\n page: string,\n navOptions: NavigationOptions = {},\n ): Promise<boolean> {\n navOptions.animationDirection = 'back';\n return this.navigateToSpacePage(space, page, navOptions);\n }\n\n public navigateForwardToSpacePage(\n space: ISpaceContext,\n page: string,\n navOptions: NavigationOptions = {},\n ): Promise<boolean> {\n navOptions.animationDirection = 'forward';\n return this.navigateToSpacePage(space, page, navOptions);\n }\n\n private navigateToSpacePage(\n space: ISpaceContext,\n page: string,\n navOptions: NavigationOptions,\n ): Promise<boolean> {\n const url = `space/${space?.type}/${space?.id}/${page}`;\n const state = navOptions.state || {};\n navOptions = { ...navOptions, state: { space, ...state } };\n return this.navController.navigateForward(url, navOptions);\n }\n\n private navForward(\n navController: NavController,\n url: string,\n navOptions: NavigationOptions,\n // _analyticsEvent: { name: string; params?: Record<string, unknown> },\n ): void {\n navController = navController || this.navController;\n // this.analyticsService.logEvent(analyticsEvent.name, analyticsEvent.params);\n navController\n .navigateForward(url, navOptions)\n .catch((err) =>\n this.errorLogger.logError(err, 'Failed to navigate to: ' + url),\n );\n }\n\n private navToSpacePage = (\n navController: NavController,\n space: ISpaceRef,\n url: string,\n eventName: string,\n params?: Record<string, unknown>,\n ): void => {\n params = { ...params, space: space.id };\n this.analyticsService.logEvent(eventName, params);\n this.navForward(\n navController,\n url,\n { queryParams: params, state: { space } },\n );\n };\n}\n"]}
|
package/index.d.ts
CHANGED
|
@@ -1,8 +1,11 @@
|
|
|
1
1
|
export * from './lib/services/space-service.module';
|
|
2
|
+
export * from './lib/services/space-nav-service.interface';
|
|
3
|
+
/** @deprecated see the class's own JSDoc for the migration path. */
|
|
2
4
|
export * from './lib/services/space-nav.service';
|
|
3
5
|
export * from './lib/services/space.service';
|
|
4
6
|
export * from './lib/services/space-item.service';
|
|
5
7
|
export * from './lib/services/space-context.service';
|
|
6
8
|
export * from './lib/services/space-module.service';
|
|
9
|
+
/** @deprecated hard-depends on the deprecated `SpaceNavService`. */
|
|
7
10
|
export * from './lib/components/with-space-input.directive';
|
|
8
11
|
export * from './lib/guards/space-home-redirect.guard';
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { InjectionToken } from '@angular/core';
|
|
2
|
+
import { Params } from '@angular/router';
|
|
3
|
+
import { IIdAndBrief } from '@sneat/core';
|
|
4
|
+
import { IRecord } from '@sneat/data';
|
|
5
|
+
import { ISpaceDbo } from '@sneat/dto';
|
|
6
|
+
import { IMemberBrief } from '@sneat/extension-contactus-contract';
|
|
7
|
+
import { ISpaceContext } from '@sneat/space-models';
|
|
8
|
+
/**
|
|
9
|
+
* Neutral push/pop transition hint. Framework-agnostic replacement for
|
|
10
|
+
* Ionic's `NavController.animationDirection`: an Ionic-backed
|
|
11
|
+
* `ISpaceNavService` implementation uses it to pick `navigateRoot` vs
|
|
12
|
+
* `navigateForward`; a plain-Angular `Router`-backed implementation ignores
|
|
13
|
+
* it.
|
|
14
|
+
*/
|
|
15
|
+
export type SpaceNavDirection = 'forward' | 'back';
|
|
16
|
+
export interface INavigateToLoginOptions {
|
|
17
|
+
readonly returnTo?: string;
|
|
18
|
+
readonly queryParams?: Params;
|
|
19
|
+
}
|
|
20
|
+
export interface ISpaceNavOptions {
|
|
21
|
+
readonly queryParams?: Params;
|
|
22
|
+
readonly state?: Record<string, unknown>;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Semantic space-navigation contract. Implementations own the actual
|
|
26
|
+
* mechanism (Ionic `NavController` nav-stack, or plain Angular `Router`) so
|
|
27
|
+
* that callers and route-agnostic libraries never import a component
|
|
28
|
+
* library.
|
|
29
|
+
*
|
|
30
|
+
* Apps provide a concrete implementation via DI — e.g.
|
|
31
|
+
* `provideSpaceNavIonicInternal()` from `@sneat/space-nav-ionic` for an
|
|
32
|
+
* Ionic app shell, or `provideSpaceNavRouterInternal()` from
|
|
33
|
+
* `@sneat/space-nav-router` for a PrimeNG / non-Ionic app.
|
|
34
|
+
*/
|
|
35
|
+
export interface ISpaceNavService {
|
|
36
|
+
navigateToSpaces(direction?: SpaceNavDirection): void;
|
|
37
|
+
navigateToLogin(options?: INavigateToLoginOptions): void;
|
|
38
|
+
navigateToUserProfile(): void;
|
|
39
|
+
navigateToSpace(space: ISpaceContext, direction?: SpaceNavDirection): Promise<boolean>;
|
|
40
|
+
navigateToMember(space: ISpaceContext, memberInfo: IIdAndBrief<IMemberBrief>): void;
|
|
41
|
+
navigateToAddMetric(team: IRecord<ISpaceDbo>): void;
|
|
42
|
+
navigateBackToSpacePage(space: ISpaceContext, page: string, navOptions?: ISpaceNavOptions): Promise<boolean>;
|
|
43
|
+
navigateForwardToSpacePage(space: ISpaceContext, page: string, navOptions?: ISpaceNavOptions): Promise<boolean>;
|
|
44
|
+
}
|
|
45
|
+
export declare const SPACE_NAV_SERVICE: InjectionToken<ISpaceNavService>;
|
|
@@ -8,6 +8,20 @@ import { ISpaceContext } from '@sneat/space-models';
|
|
|
8
8
|
import * as i0 from "@angular/core";
|
|
9
9
|
type NavigationOptions = NonNullable<Parameters<NavController['navigateRoot']>[1]>;
|
|
10
10
|
export type ScrumPageTab = 'team' | 'my' | 'risks' | 'qna';
|
|
11
|
+
/**
|
|
12
|
+
* @deprecated Concrete, Ionic-coupled nav service. Kept for backward
|
|
13
|
+
* compatibility — a currently-published dependency of this monorepo
|
|
14
|
+
* (`@sneat/extension-contactus-shared@0.12.3`) still imports this class and
|
|
15
|
+
* `WithSpaceInput` directly from `@sneat/space-services`, so it cannot be
|
|
16
|
+
* removed from this package's public entry point without breaking that
|
|
17
|
+
* consumer; see the PR description for the full trade-off.
|
|
18
|
+
*
|
|
19
|
+
* New code should depend on `ISpaceNavService` (the `SPACE_NAV_SERVICE`
|
|
20
|
+
* injection token, also exported from this package) and have the app
|
|
21
|
+
* provide an implementation via `provideSpaceNavIonicInternal()` from
|
|
22
|
+
* `@sneat/space-nav-ionic`, or `provideSpaceNavRouterInternal()` from
|
|
23
|
+
* `@sneat/space-nav-router` for non-Ionic apps.
|
|
24
|
+
*/
|
|
11
25
|
export declare class SpaceNavService {
|
|
12
26
|
private readonly errorLogger;
|
|
13
27
|
private readonly navController;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sneat/space-services",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.26.0",
|
|
4
4
|
"publishConfig": {
|
|
5
5
|
"access": "public"
|
|
6
6
|
},
|
|
@@ -12,6 +12,11 @@
|
|
|
12
12
|
"@angular/fire": ">=20",
|
|
13
13
|
"@sneat/extension-contactus-contract": "^0.12.0"
|
|
14
14
|
},
|
|
15
|
+
"peerDependenciesMeta": {
|
|
16
|
+
"@ionic/angular": {
|
|
17
|
+
"optional": true
|
|
18
|
+
}
|
|
19
|
+
},
|
|
15
20
|
"dependencies": {
|
|
16
21
|
"tslib": "2.8.1"
|
|
17
22
|
},
|