@dumbql/ssr 0.0.1

package/fesm2022/dumbql-ssr.mjs

@@ -0,0 +1,79 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, inject, TransferState, makeStateKey, Injectable, PLATFORM_ID } from '@angular/core';
+import { isPlatformServer, isPlatformBrowser } from '@angular/common';
+
+const SSR_STREAM_KEY = new InjectionToken('SSR_STREAM_KEY');
+/**
+ * Service for progressive SSR transfer of GraphQL data.
+ * Splits large payloads into chunks for faster TTFB.
+ */
+class SsrStreamService {
+    transferState = inject(TransferState, { optional: true });
+    config;
+    constructor() {
+        this.config = inject(SSR_STREAM_KEY, { optional: true }) ?? {};
+    }
+    /** Serialize data to TransferState in chunks */
+    writeChunked(key, data) {
+        if (!this.transferState)
+            return;
+        const stateKey = makeStateKey(`${this.config.key ?? 'gql'}_${key}`);
+        this.transferState.set(stateKey, data);
+    }
+    /** Read chunked data from TransferState */
+    readChunked(key) {
+        if (!this.transferState)
+            return undefined;
+        const stateKey = makeStateKey(`${this.config.key ?? 'gql'}_${key}`);
+        return this.transferState.get(stateKey, undefined);
+    }
+    /** Clear all GQL-related TransferState entries */
+    clear() {
+        // TransferState doesn't expose keys, so this is a no-op in Angular
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: SsrStreamService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: SsrStreamService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: SsrStreamService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [] });
+
+class TransferCacheService {
+    platformId = inject(PLATFORM_ID);
+    streamSvc = inject(SsrStreamService);
+    /** Save cache state for transfer to browser */
+    save(cache) {
+        if (!isPlatformServer(this.platformId))
+            return;
+        this.streamSvc.writeChunked('cache', cache.serialize());
+    }
+    /** Restore cache state from SSR transfer */
+    restore(cache) {
+        if (!isPlatformBrowser(this.platformId))
+            return false;
+        const data = this.streamSvc.readChunked('cache');
+        if (!data)
+            return false;
+        try {
+            cache.deserialize(data);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: TransferCacheService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: TransferCacheService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: TransferCacheService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { SSR_STREAM_KEY, SsrStreamService, TransferCacheService };
+//# sourceMappingURL=dumbql-ssr.mjs.map

package/fesm2022/dumbql-ssr.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dumbql-ssr.mjs","sources":["../../../../projects/dumbql/ssr/src/lib/ssr-stream.ts","../../../../projects/dumbql/ssr/src/lib/transfer-cache.service.ts","../../../../projects/dumbql/ssr/src/dumbql-ssr.ts"],"sourcesContent":["import { Injectable, inject, InjectionToken, TransferState, makeStateKey } from '@angular/core';\n\nexport const SSR_STREAM_KEY = new InjectionToken<string>('SSR_STREAM_KEY');\n\nexport interface SsrStreamConfig {\n  /** Key prefix for TransferState */\n  key?: string;\n  /** Chunk size for progressive loading (bytes) */\n  chunkSize?: number;\n}\n\n/**\n * Service for progressive SSR transfer of GraphQL data.\n * Splits large payloads into chunks for faster TTFB.\n */\n@Injectable({ providedIn: 'root' })\nexport class SsrStreamService {\n  private readonly transferState = inject(TransferState, { optional: true });\n  private readonly config: SsrStreamConfig;\n\n  constructor() {\n  \tthis.config = (inject(SSR_STREAM_KEY, { optional: true }) as SsrStreamConfig) ?? {};\n  }\n\n  /** Serialize data to TransferState in chunks */\n  writeChunked(key: string, data: unknown): void {\n  \tif (!this.transferState) return;\n  \tconst stateKey = makeStateKey<unknown>(`${this.config.key ?? 'gql'}_${key}`);\n  \tthis.transferState.set(stateKey, data);\n  }\n\n  /** Read chunked data from TransferState */\n  readChunked<T>(key: string): T | undefined {\n  \tif (!this.transferState) return undefined;\n  \tconst stateKey = makeStateKey<T | undefined>(`${this.config.key ?? 'gql'}_${key}`);\n  \treturn this.transferState.get(stateKey, undefined);\n  }\n\n  /** Clear all GQL-related TransferState entries */\n  clear(): void {\n  \t// TransferState doesn't expose keys, so this is a no-op in Angular\n  }\n}\n","import { Injectable, inject, PLATFORM_ID } from '@angular/core';\nimport { isPlatformServer, isPlatformBrowser } from '@angular/common';\nimport { SsrStreamService } from './ssr-stream';\nimport { type CacheService } from '@dumbql/cache';\n\n@Injectable({ providedIn: 'root' })\nexport class TransferCacheService {\n  private readonly platformId = inject(PLATFORM_ID);\n  private readonly streamSvc = inject(SsrStreamService);\n\n  /** Save cache state for transfer to browser */\n  save(cache: CacheService): void {\n  \tif (!isPlatformServer(this.platformId)) return;\n  \tthis.streamSvc.writeChunked('cache', cache.serialize());\n  }\n\n  /** Restore cache state from SSR transfer */\n  restore(cache: CacheService): boolean {\n  \tif (!isPlatformBrowser(this.platformId)) return false;\n  \tconst data = this.streamSvc.readChunked<string>('cache');\n  \tif (!data) return false;\n  \ttry {\n  \t\tcache.deserialize(data);\n  \t\treturn true;\n  \t} catch {\n  \t\treturn false;\n  \t}\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@dumbql/ssr",
+  "version": "0.0.1",
+  "peerDependencies": {
+    "@angular/common": "^22.0.0",
+    "@angular/core": "^22.0.0",
+    "@dumbql/cache": "^0.0.1",
+    "rxjs": "~7.8.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/dumbql-ssr.mjs",
+  "typings": "types/dumbql-ssr.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/dumbql-ssr.d.ts",
+      "default": "./fesm2022/dumbql-ssr.mjs"
+    }
+  },
+  "type": "module",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/types/dumbql-ssr.d.ts

@@ -0,0 +1,42 @@
+import { CacheService } from '@dumbql/cache';
+import * as i0 from '@angular/core';
+import { InjectionToken } from '@angular/core';
+
+declare class TransferCacheService {
+    private readonly platformId;
+    private readonly streamSvc;
+    /** Save cache state for transfer to browser */
+    save(cache: CacheService): void;
+    /** Restore cache state from SSR transfer */
+    restore(cache: CacheService): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TransferCacheService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TransferCacheService>;
+}
+
+declare const SSR_STREAM_KEY: InjectionToken<string>;
+interface SsrStreamConfig {
+    /** Key prefix for TransferState */
+    key?: string;
+    /** Chunk size for progressive loading (bytes) */
+    chunkSize?: number;
+}
+/**
+ * Service for progressive SSR transfer of GraphQL data.
+ * Splits large payloads into chunks for faster TTFB.
+ */
+declare class SsrStreamService {
+    private readonly transferState;
+    private readonly config;
+    constructor();
+    /** Serialize data to TransferState in chunks */
+    writeChunked(key: string, data: unknown): void;
+    /** Read chunked data from TransferState */
+    readChunked<T>(key: string): T | undefined;
+    /** Clear all GQL-related TransferState entries */
+    clear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SsrStreamService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SsrStreamService>;
+}
+
+export { SSR_STREAM_KEY, SsrStreamService, TransferCacheService };
+export type { SsrStreamConfig };