@viengut/vgq-sdk 0.2.0 → 0.3.0

package/dist/client.d.ts

@@ -30,6 +30,12 @@ export declare class VgqClient {
     /** Tải một Form Version bất biến (Response luôn gắn đúng version đã bắt đầu). */
     getFormVersion(id: string): Promise<FormVersion>;
     createResponse(publicationKey: string, options?: StartResponseOptions): Promise<ResponseDto>;
+    /**
+     * Bắt đầu Response xem thử trên bản Draft của Form (trang demo cổng bệnh
+     * nhân). Server chụp Draft vào shadow snapshot version và XOÁ Response
+     * preview cũ của Form — mỗi Form chỉ giữ một bản thử.
+     */
+    createPreviewResponse(formId: string, options?: StartResponseOptions): Promise<ResponseDto>;
     getInvitation(id: string): Promise<InvitationDto>;
     /** Bắt đầu (hoặc mở lại) Response duy nhất của một Invitation. */
     startInvitationResponse(invitationId: string): Promise<ResponseDto>;

package/dist/client.js

@@ -40,6 +40,18 @@ export class VgqClient {
             care_context_ref: options.careContextRef ?? null,
         }, headers);
     }
+    /**
+     * Bắt đầu Response xem thử trên bản Draft của Form (trang demo cổng bệnh
+     * nhân). Server chụp Draft vào shadow snapshot version và XOÁ Response
+     * preview cũ của Form — mỗi Form chỉ giữ một bản thử.
+     */
+    createPreviewResponse(formId, options = {}) {
+        return this.request('POST', `/api/forms/${encodeURIComponent(formId)}/preview-responses`, {
+            subject_ref: options.subjectRef ?? null,
+            respondent_ref: options.respondentRef ?? null,
+            care_context_ref: options.careContextRef ?? null,
+        });
+    }
     getInvitation(id) {
         return this.request('GET', `/api/invitations/${encodeURIComponent(id)}`);
     }

package/dist/session.d.ts

@@ -2,7 +2,7 @@ import type { VgqClient } from './client.js';
 import type { ActiveState, CompletionResult } from './engine.js';
 import type { FormDefinition, JsonValue, ResponseDto, ResponseValues } from './types.js';
 /** Phần VgqClient mà ResponseSession cần — thu hẹp để test dễ stub. */
-export type SessionClient = Pick<VgqClient, 'getFormVersion' | 'createResponse' | 'startInvitationResponse' | 'getResponse' | 'updateValues' | 'completeResponse'>;
+export type SessionClient = Pick<VgqClient, 'getFormVersion' | 'createResponse' | 'createPreviewResponse' | 'startInvitationResponse' | 'getResponse' | 'updateValues' | 'completeResponse'>;
 export interface SessionOptions {
     /** Thời gian gom thay đổi trước khi đồng bộ lên server (ms). Mặc định 800. */
     debounceMs?: number;
@@ -14,8 +14,13 @@ export interface SessionOptions {
 export interface StartSessionOptions {
     /** Bắt đầu qua Publication key... */
     publicationKey?: string;
-    /** ...hoặc qua Invitation đã được tạo sẵn. */
+    /** ...hoặc qua Invitation đã được tạo sẵn... */
     invitationId?: string;
+    /**
+     * ...hoặc xem thử bản Draft của một Form (chưa phát hành). Server chụp
+     * Draft thành snapshot và thay thế Response preview cũ của Form đó.
+     */
+    previewFormId?: string;
     subjectRef?: string;
     respondentRef?: string;
     careContextRef?: string;

package/dist/session.js

@@ -41,8 +41,15 @@ export class ResponseSession {
                 idempotencyKey: start.idempotencyKey,
             });
         }
+        else if (start.previewFormId) {
+            response = await client.createPreviewResponse(start.previewFormId, {
+                subjectRef: start.subjectRef,
+                respondentRef: start.respondentRef,
+                careContextRef: start.careContextRef,
+            });
+        }
         else {
-            throw new Error('Cần publicationKey hoặc invitationId để bắt đầu Response');
+            throw new Error('Cần publicationKey, invitationId hoặc previewFormId để bắt đầu Response');
         }
         // Định nghĩa lấy theo đúng Form Version mà Response đã ghim, không phải
         // version mới nhất của Publication (Draft không đổi Form giữa chừng).

package/dist/types.d.ts

@@ -151,6 +151,8 @@ export interface ResponseDto {
     updated_at: string;
     completed_at: string | null;
     completed_by: string | null;
+    /** Response xem thử từ trang demo cổng bệnh nhân (server < 0.3.0 không trả). */
+    is_preview?: boolean;
 }
 export interface PublicationForm {
     publication_key: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viengut/vgq-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Headless TypeScript SDK for the VGQ clinical form platform: load published Forms, manage Response state, evaluate Enable Conditions and validate Response Values without any UI components.",
   "repository": {
     "type": "git",