bways-report 0.1.4 → 0.1.5

package/lib/core/services/index.d.ts

@@ -1,3 +1,4 @@
 export { DynamicFormBuilder } from './dynamic-form-builder.service';
 export { ReportSessionContextService } from './report-session-context.service';
 export type { SessionParamMatch, DerivedParametersResult, } from './report-session-context.service';
+export { ReportStorageService } from './report-storage.service';

package/lib/core/services/report-storage.service.d.ts

@@ -0,0 +1,26 @@
+import { ReportStorage } from '../tokens/storage.token';
+import * as i0 from "@angular/core";
+/**
+ * Angular injectable service wrapping report storage operations.
+ * Provides type-safe JSON serialization/deserialization and environment-agnostic access.
+ */
+export declare class ReportStorageService implements ReportStorage {
+    private readonly storage;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+    key(index: number): string | null;
+    get length(): number;
+    /**
+     * Safely retrieves and parses a JSON value from storage.
+     * Returns fallback if key is missing or parsing fails.
+     */
+    getJSON<T>(key: string, fallback: T): T;
+    /**
+     * Safely serializes and stores a JSON value in storage.
+     */
+    setJSON<T>(key: string, value: T): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReportStorageService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ReportStorageService>;
+}

package/lib/core/tokens/index.d.ts

@@ -2,3 +2,5 @@ export { REPORTING_CONFIG, GRID_COMPONENT, CHART_COMPONENT, } from './reporting-
 export type { ReportingConfig, } from './reporting-config.token';
 export { REPORT_SESSION_CONTEXT, REPORT_SESSION_PROVIDER, SessionContextProvider, } from './session-context.token';
 export type { SessionParamPrimitive, SessionContextMap, SessionContextProviderFn, SessionContextSource, } from './session-context.token';
+export { REPORT_STORAGE, BrowserReportStorage, MemoryReportStorage, } from './storage.token';
+export type { ReportStorage, } from './storage.token';

package/lib/core/tokens/storage.token.d.ts

@@ -0,0 +1,48 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * Storage contract for reading and writing report configurations,
+ * presets, and layout states across environments (Browser, SSR, sandboxed iframes).
+ */
+export interface ReportStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+    key?(index: number): string | null;
+    readonly length?: number;
+}
+/**
+ * In-memory fallback implementation of ReportStorage.
+ * Safe for SSR, unit tests, and sandboxed iframes where localStorage access is denied.
+ */
+export declare class MemoryReportStorage implements ReportStorage {
+    private readonly store;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+    key(index: number): string | null;
+    get length(): number;
+}
+/**
+ * Browser localStorage-backed implementation of ReportStorage
+ * with transparent in-memory fallback on DOMException or SSR.
+ */
+export declare class BrowserReportStorage implements ReportStorage {
+    private readonly memory;
+    private readonly isSupported;
+    constructor();
+    private checkStorageSupport;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+    key(index: number): string | null;
+    get length(): number;
+}
+/**
+ * Injection token for the report storage engine.
+ * Defaults to `BrowserReportStorage`, which transparently falls back to
+ * `MemoryReportStorage` when browser localStorage is unavailable or restricted.
+ */
+export declare const REPORT_STORAGE: InjectionToken<ReportStorage>;

package/lib/data-access/adapters/local-storage-persistence.adapter.d.ts

@@ -4,6 +4,7 @@ import { ReportDefinition, ReportSummary } from '../../core/models/report-defini
 import * as i0 from "@angular/core";
 export declare class LocalStorageReportPersistenceAdapter extends ReportPersistenceAdapter {
     private readonly templateService;
+    private readonly storage;
     constructor();
     private seedDefaultBlueprintsIfEmpty;
     private getIndex;

package/lib/features/runtime/report-grid-bridge.component.d.ts

@@ -24,6 +24,7 @@ export declare class RptGridOutletDirective implements OnDestroy {
 }
 export declare class ReportGridBridgeComponent {
     private readonly injectedGrid;
+    private readonly storage;
     constructor();
     readonly gridDefinition: import("@angular/core").InputSignal<ReportGridDefinition>;
     readonly data: import("@angular/core").InputSignal<unknown[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bways-report",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Enterprise-grade, metadata-driven reporting engine and visual page builder for Angular 18+ ERP applications.",
   "keywords": [
     "angular",
@@ -15,6 +15,14 @@
   ],
   "author": "CCPL / BWays Team",
   "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ccplProject/BWays-CustomeReport.git"
+  },
+  "homepage": "https://github.com/ccplProject/BWays-CustomeReport#readme",
+  "bugs": {
+    "url": "https://github.com/ccplProject/BWays-CustomeReport/issues"
+  },
   "peerDependencies": {
     "@angular/common": ">=18.0.0",
     "@angular/core": ">=18.0.0",