@dereekb/nestjs 13.10.8 → 13.10.9

package/mailgun/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/mailgun",
-  "version": "13.10.8",
+  "version": "13.10.9",
   "peerDependencies": {
-    "@dereekb/date": "13.10.8",
-    "@dereekb/model": "13.10.8",
-    "@dereekb/nestjs": "13.10.8",
-    "@dereekb/rxjs": "13.10.8",
-    "@dereekb/util": "13.10.8",
+    "@dereekb/date": "13.10.9",
+    "@dereekb/model": "13.10.9",
+    "@dereekb/nestjs": "13.10.9",
+    "@dereekb/rxjs": "13.10.9",
+    "@dereekb/util": "13.10.9",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "form-data": "^4.0.5",

package/openai/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/openai",
-  "version": "13.10.8",
+  "version": "13.10.9",
   "peerDependencies": {
-    "@dereekb/date": "13.10.8",
-    "@dereekb/model": "13.10.8",
-    "@dereekb/nestjs": "13.10.8",
-    "@dereekb/rxjs": "13.10.8",
-    "@dereekb/util": "13.10.8",
+    "@dereekb/date": "13.10.9",
+    "@dereekb/model": "13.10.9",
+    "@dereekb/nestjs": "13.10.9",
+    "@dereekb/rxjs": "13.10.9",
+    "@dereekb/util": "13.10.9",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "express": "^5.2.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/nestjs",
-  "version": "13.10.8",
+  "version": "13.10.9",
   "types": "./src/index.d.ts",
   "module": "./index.esm.js",
   "main": "./index.cjs.js",
@@ -56,8 +56,8 @@
     }
   },
   "peerDependencies": {
-    "@dereekb/rxjs": "13.10.8",
-    "@dereekb/util": "13.10.8",
+    "@dereekb/rxjs": "13.10.9",
+    "@dereekb/util": "13.10.9",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "@typeform/api-client": "^2.10.2",

package/src/lib/util/index.d.ts

@@ -1 +1,2 @@
 export * from './encryption';
+export * from './pdf';

package/src/lib/util/pdf/index.d.ts

@@ -0,0 +1 @@
+export * from './pdf.encryption';

package/src/lib/util/pdf/pdf.encryption.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Encryption status returned by {@link detectPdfEncryption}.
+ *
+ * - `none`: PDF is not encrypted.
+ * - `write_protected_only`: PDF carries an `/Encrypt` dictionary but can be opened with
+ *   an empty user password — the encryption only restricts editing/printing/etc.
+ * - `fully_encrypted`: PDF requires a non-empty user password to be opened.
+ * - `unknown_encrypted`: PDF carries an `/Encrypt` dictionary but the encryption
+ *   parameters could not be parsed or use a security handler we do not understand.
+ *   Treat as encrypted by default.
+ */
+export type PdfEncryptionStatus = 'none' | 'write_protected_only' | 'fully_encrypted' | 'unknown_encrypted';
+/**
+ * Detects whether a PDF is unencrypted, write-protected (openable without a password
+ * but restricted from editing/printing), or fully encrypted (requires a password to open).
+ *
+ * Implements the user-password validation algorithms from ISO 32000-1 §7.6.3 (R≤4) and
+ * ISO 32000-2 §7.6.4.4 (R=5/6) using only the empty password. If the empty password
+ * validates successfully, the PDF is openable by anyone and only its modify/print/copy
+ * permissions are restricted; otherwise a non-empty user password is required.
+ *
+ * Supported security handlers:
+ * - Standard security handler, R=2,3,4 (RC4-40, RC4-128, AES-128 with crypt filters).
+ * - Standard security handler, R=5 (AES-256, deprecated Adobe extension).
+ * - Standard security handler, R=6 (AES-256, ISO 32000-2 / PDF 2.0).
+ *
+ * Unrecognised security handlers (e.g. PubSec, custom handlers) return
+ * `unknown_encrypted` so callers can choose whether to treat them as fully encrypted.
+ *
+ * Lives in `@dereekb/nestjs` (rather than `@dereekb/util`) because it uses Node's
+ * built-in `node:crypto` module, which isn't available in the browser.
+ *
+ * @example
+ * ```ts
+ * const status = detectPdfEncryption(buffer);
+ *
+ * if (status === 'fully_encrypted') {
+ *   throw new Error('PDF requires a password to open.');
+ * }
+ * if (status === 'write_protected_only') {
+ *   // Safe to read, but not to mutate without the owner password.
+ * }
+ * ```
+ *
+ * @param buffer - PDF file contents.
+ * @returns The encryption status of the PDF.
+ */
+export declare function detectPdfEncryption(buffer: Buffer): PdfEncryptionStatus;

package/stripe/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/stripe",
-  "version": "13.10.8",
+  "version": "13.10.9",
   "peerDependencies": {
-    "@dereekb/date": "13.10.8",
-    "@dereekb/model": "13.10.8",
-    "@dereekb/nestjs": "13.10.8",
-    "@dereekb/rxjs": "13.10.8",
-    "@dereekb/util": "13.10.8",
+    "@dereekb/date": "13.10.9",
+    "@dereekb/model": "13.10.9",
+    "@dereekb/nestjs": "13.10.9",
+    "@dereekb/rxjs": "13.10.9",
+    "@dereekb/util": "13.10.9",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "express": "^5.2.1",

package/typeform/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/typeform",
-  "version": "13.10.8",
+  "version": "13.10.9",
   "peerDependencies": {
-    "@dereekb/date": "13.10.8",
-    "@dereekb/model": "13.10.8",
-    "@dereekb/nestjs": "13.10.8",
-    "@dereekb/rxjs": "13.10.8",
-    "@dereekb/util": "13.10.8",
+    "@dereekb/date": "13.10.9",
+    "@dereekb/model": "13.10.9",
+    "@dereekb/nestjs": "13.10.9",
+    "@dereekb/rxjs": "13.10.9",
+    "@dereekb/util": "13.10.9",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "@typeform/api-client": "^2.10.2",

package/vapiai/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/vapiai",
-  "version": "13.10.8",
+  "version": "13.10.9",
   "peerDependencies": {
-    "@dereekb/date": "13.10.8",
-    "@dereekb/model": "13.10.8",
-    "@dereekb/nestjs": "13.10.8",
-    "@dereekb/rxjs": "13.10.8",
-    "@dereekb/util": "13.10.8",
+    "@dereekb/date": "13.10.9",
+    "@dereekb/model": "13.10.9",
+    "@dereekb/nestjs": "13.10.9",
+    "@dereekb/rxjs": "13.10.9",
+    "@dereekb/util": "13.10.9",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "@vapi-ai/server-sdk": "^0.11.0",