@zucker-framework/fe-types 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,7 @@
+# Frontend shared contracts
+
+This package exports frontend-safe types, runtime schemas and template-variable extraction. `redactFields(value, sensitiveFields, replacement?)` recursively copies JSON-like data, replacing explicitly selected keys without mutating the input. Field matching is case-sensitive; the default replacement is `[Redacted]`. Consumers retain sensitive-field lists and reporter hooks.
+
+The redaction primitive has no Node, NestJS or backend dependencies. It expects JSON-like objects and arrays, matching error-report payloads. Its source contracts are in `src/redact-fields.spec.ts`; a new immutable release and consumer validation are required before adopting new exports from the registry.
+
+`redactFields` now reuses `@zucker-framework/core/privacy`. `inspectUserAgent(ua)` and `UserAgentDetails` reuse `@zucker-framework/core/user-agent`, exposing nullable browser/OS/device details and desktop/mobile/tablet/bot classification. The application chooses labels, missing-value text and version display. These explicit Core entry points contain no Node dependencies; frontend code does not import the Core root.

package/dist/index.d.mts

@@ -1,4 +1,6 @@
 import { z } from 'zod/v4';
+export { redactFields } from '@zucker-framework/core/privacy';
+export { UserAgentDetails, inspectUserAgent } from '@zucker-framework/core/user-agent';
 
 /**
  * Zod Schemas — 前后端共享的 Single Source of Truth
@@ -160,6 +162,11 @@ declare const LoginResponseSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 
+/** 匹配 {{variableName}} 占位符（仅 \w：字母数字下划线） */
+declare const TEMPLATE_VARIABLE_REGEX: RegExp;
+/** 从一段或多段 HTML 中提取所有 {{variable}} 名称，去重 */
+declare function extractTemplateVariables(...htmls: Array<string | null | undefined>): string[];
+
 /** Represents an authenticated user in the system. */
 interface User {
     /** Unique user identifier. */
@@ -291,4 +298,4 @@ interface AuthState {
     permissions: string[];
 }
 
-export { ApiErrorResponseSchema, type ApiResponse, ApiResponseSchema, type AuthState, AuthStateSchema, CreateUserSchema, type DictionaryItem, DictionaryItemSchema, LoginRequestSchema, LoginResponseSchema, type MenuItem, MenuItemSchema, type PaginatedResponse, PaginatedResponseSchema, type SelectOption, SelectOptionSchema, type TreeNode, TreeNodeSchema, UpdateUserSchema, type UploadFile, UploadFileSchema, type User, UserSchema };
+export { ApiErrorResponseSchema, type ApiResponse, ApiResponseSchema, type AuthState, AuthStateSchema, CreateUserSchema, type DictionaryItem, DictionaryItemSchema, LoginRequestSchema, LoginResponseSchema, type MenuItem, MenuItemSchema, type PaginatedResponse, PaginatedResponseSchema, type SelectOption, SelectOptionSchema, TEMPLATE_VARIABLE_REGEX, type TreeNode, TreeNodeSchema, UpdateUserSchema, type UploadFile, UploadFileSchema, type User, UserSchema, extractTemplateVariables };

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import { z } from 'zod/v4';
+export { redactFields } from '@zucker-framework/core/privacy';
+export { UserAgentDetails, inspectUserAgent } from '@zucker-framework/core/user-agent';
 
 /**
  * Zod Schemas — 前后端共享的 Single Source of Truth
@@ -160,6 +162,11 @@ declare const LoginResponseSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 
+/** 匹配 {{variableName}} 占位符（仅 \w：字母数字下划线） */
+declare const TEMPLATE_VARIABLE_REGEX: RegExp;
+/** 从一段或多段 HTML 中提取所有 {{variable}} 名称，去重 */
+declare function extractTemplateVariables(...htmls: Array<string | null | undefined>): string[];
+
 /** Represents an authenticated user in the system. */
 interface User {
     /** Unique user identifier. */
@@ -291,4 +298,4 @@ interface AuthState {
     permissions: string[];
 }
 
-export { ApiErrorResponseSchema, type ApiResponse, ApiResponseSchema, type AuthState, AuthStateSchema, CreateUserSchema, type DictionaryItem, DictionaryItemSchema, LoginRequestSchema, LoginResponseSchema, type MenuItem, MenuItemSchema, type PaginatedResponse, PaginatedResponseSchema, type SelectOption, SelectOptionSchema, type TreeNode, TreeNodeSchema, UpdateUserSchema, type UploadFile, UploadFileSchema, type User, UserSchema };
+export { ApiErrorResponseSchema, type ApiResponse, ApiResponseSchema, type AuthState, AuthStateSchema, CreateUserSchema, type DictionaryItem, DictionaryItemSchema, LoginRequestSchema, LoginResponseSchema, type MenuItem, MenuItemSchema, type PaginatedResponse, PaginatedResponseSchema, type SelectOption, SelectOptionSchema, TEMPLATE_VARIABLE_REGEX, type TreeNode, TreeNodeSchema, UpdateUserSchema, type UploadFile, UploadFileSchema, type User, UserSchema, extractTemplateVariables };

package/dist/index.js

@@ -30,10 +30,14 @@ __export(index_exports, {
   MenuItemSchema: () => MenuItemSchema,
   PaginatedResponseSchema: () => PaginatedResponseSchema,
   SelectOptionSchema: () => SelectOptionSchema,
+  TEMPLATE_VARIABLE_REGEX: () => TEMPLATE_VARIABLE_REGEX,
   TreeNodeSchema: () => TreeNodeSchema,
   UpdateUserSchema: () => UpdateUserSchema,
   UploadFileSchema: () => UploadFileSchema,
-  UserSchema: () => UserSchema
+  UserSchema: () => UserSchema,
+  extractTemplateVariables: () => extractTemplateVariables,
+  inspectUserAgent: () => import_user_agent.inspectUserAgent,
+  redactFields: () => import_privacy.redactFields
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -128,6 +132,25 @@ var LoginResponseSchema = import_v4.z.object({
   refreshToken: import_v4.z.string().optional(),
   user: UserSchema
 });
+
+// src/template-variables.ts
+var TEMPLATE_VARIABLE_REGEX = /\{\{(\w+)\}\}/g;
+function extractTemplateVariables(...htmls) {
+  const found = /* @__PURE__ */ new Set();
+  for (const html of htmls) {
+    if (!html) continue;
+    for (const m of html.matchAll(TEMPLATE_VARIABLE_REGEX)) {
+      found.add(m[1]);
+    }
+  }
+  return [...found];
+}
+
+// src/redact-fields.ts
+var import_privacy = require("@zucker-framework/core/privacy");
+
+// src/index.ts
+var import_user_agent = require("@zucker-framework/core/user-agent");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ApiErrorResponseSchema,
@@ -140,8 +163,12 @@ var LoginResponseSchema = import_v4.z.object({
   MenuItemSchema,
   PaginatedResponseSchema,
   SelectOptionSchema,
+  TEMPLATE_VARIABLE_REGEX,
   TreeNodeSchema,
   UpdateUserSchema,
   UploadFileSchema,
-  UserSchema
+  UserSchema,
+  extractTemplateVariables,
+  inspectUserAgent,
+  redactFields
 });

package/dist/index.mjs

@@ -89,6 +89,25 @@ var LoginResponseSchema = z.object({
   refreshToken: z.string().optional(),
   user: UserSchema
 });
+
+// src/template-variables.ts
+var TEMPLATE_VARIABLE_REGEX = /\{\{(\w+)\}\}/g;
+function extractTemplateVariables(...htmls) {
+  const found = /* @__PURE__ */ new Set();
+  for (const html of htmls) {
+    if (!html) continue;
+    for (const m of html.matchAll(TEMPLATE_VARIABLE_REGEX)) {
+      found.add(m[1]);
+    }
+  }
+  return [...found];
+}
+
+// src/redact-fields.ts
+import { redactFields } from "@zucker-framework/core/privacy";
+
+// src/index.ts
+import { inspectUserAgent } from "@zucker-framework/core/user-agent";
 export {
   ApiErrorResponseSchema,
   ApiResponseSchema,
@@ -100,8 +119,12 @@ export {
   MenuItemSchema,
   PaginatedResponseSchema,
   SelectOptionSchema,
+  TEMPLATE_VARIABLE_REGEX,
   TreeNodeSchema,
   UpdateUserSchema,
   UploadFileSchema,
-  UserSchema
+  UserSchema,
+  extractTemplateVariables,
+  inspectUserAgent,
+  redactFields
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zucker-framework/fe-types",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -24,7 +24,8 @@
     "THIRD_PARTY_NOTICES"
   ],
   "dependencies": {
-    "zod": "^4.5.4"
+    "zod": "^4.5.4",
+    "@zucker-framework/core": "1.0.2"
   },
   "license": "Apache-2.0",
   "author": "Lind",