@case-framework/survey-assistant 0.7.0 → 0.8.0

package/dist/controller-proxy-DEeFl9IA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-proxy-DEeFl9IA.mjs","names":[],"sources":["../src/react/client-error.ts","../src/react/thread-launcher.ts","../src/react/task-client.ts","../src/react/controller-proxy.ts"],"sourcesContent":["import {\n  isSurveyAssistantErrorRetryable,\n  parseSurveyAssistantError,\n  type SurveyAssistantErrorCode,\n  type SurveyAssistantErrorInfo,\n} from \"../protocol\";\n\nexport class SurveyAssistantClientError extends Error {\n  readonly code: SurveyAssistantErrorCode;\n  readonly retryable: boolean;\n  readonly upstreamStatus?: number;\n  readonly providerRequestId?: string;\n  readonly providerMessage?: string;\n\n  constructor(\n    code: SurveyAssistantErrorCode,\n    message: string,\n    retryable = false,\n    diagnostics: Pick<\n      SurveyAssistantErrorInfo,\n      \"providerMessage\" | \"providerRequestId\" | \"upstreamStatus\"\n    > = {},\n  ) {\n    super(message);\n    this.name = \"SurveyAssistantClientError\";\n    this.code = code;\n    this.retryable = retryable;\n    this.upstreamStatus = diagnostics.upstreamStatus;\n    this.providerRequestId = diagnostics.providerRequestId;\n    this.providerMessage = diagnostics.providerMessage;\n  }\n}\n\nexport const readSurveyAssistantJson = async (\n  response: Response,\n  fallback = \"The assistant request could not be completed.\",\n) => {\n  if (!response.ok) {\n    const responseText = await response.text().catch(() => \"\");\n    let body: unknown;\n    try {\n      body = responseText ? JSON.parse(responseText) : undefined;\n    } catch {\n      body = undefined;\n    }\n    const detail =\n      typeof body === \"object\" && body !== null && \"error\" in body && typeof body.error === \"string\"\n        ? body.error\n        : responseText.trim() || fallback;\n    const parsed = parseSurveyAssistantError(\n      typeof body === \"object\" && body !== null && \"code\" in body && typeof body.code === \"string\"\n        ? {\n            code: body.code,\n            detail,\n            retryable:\n              \"retryable\" in body && typeof body.retryable === \"boolean\"\n                ? body.retryable\n                : undefined,\n            upstreamStatus:\n              \"upstreamStatus\" in body && typeof body.upstreamStatus === \"number\"\n                ? body.upstreamStatus\n                : undefined,\n            providerRequestId:\n              \"providerRequestId\" in body && typeof body.providerRequestId === \"string\"\n                ? body.providerRequestId\n                : undefined,\n            providerMessage:\n              \"providerMessage\" in body && typeof body.providerMessage === \"string\"\n                ? body.providerMessage\n                : undefined,\n          }\n        : detail,\n    );\n    const retryable = isSurveyAssistantErrorRetryable(parsed, response.status);\n    throw new SurveyAssistantClientError(parsed.code, parsed.detail ?? detail, retryable, parsed);\n  }\n  return response.json().catch(() => ({}));\n};\n","import type {\n  SurveyAssistantSnapshot,\n  SurveyAssistantThread,\n  SurveyEditorUIContext,\n} from \"../protocol\";\nimport type { FileUIPart } from \"ai\";\n\nexport type SurveyAssistantLaunchUIContext = Partial<Omit<SurveyEditorUIContext, \"history\">>;\n\nexport interface SurveyAssistantThreadLaunch {\n  /** User-visible prompt submitted as the first message in the new thread. */\n  prompt: string;\n  files?: FileUIPart[];\n  /** Optional model used for the opening assistant turn. */\n  modelId?: string;\n  /** Optional manual thread title. The prompt-derived automatic title is used by default. */\n  title?: string;\n  /** Turn-local editor context merged into the snapshot captured when the prompt is submitted. */\n  uiContext?: SurveyAssistantLaunchUIContext;\n}\n\nexport interface SurveyAssistantThreadLauncher {\n  /**\n   * Creates a new thread and submits its first prompt when a connected panel is ready.\n   * Calls made before the panel mounts are queued.\n   */\n  startThread(input: SurveyAssistantThreadLaunch): Promise<SurveyAssistantThread>;\n}\n\ntype LaunchHandler = (input: SurveyAssistantThreadLaunch) => Promise<SurveyAssistantThread>;\n\ninterface PendingLaunch {\n  input: SurveyAssistantThreadLaunch;\n  reject(error: unknown): void;\n  resolve(thread: SurveyAssistantThread): void;\n}\n\ninterface LauncherState {\n  handler: LaunchHandler | null;\n  pending: PendingLaunch[];\n  draining: boolean;\n}\n\nconst launcherStates = new WeakMap<SurveyAssistantThreadLauncher, LauncherState>();\n\nexport const applySurveyAssistantLaunchUIContext = (\n  snapshot: SurveyAssistantSnapshot | null,\n  uiContext: SurveyAssistantLaunchUIContext | undefined,\n): SurveyAssistantSnapshot | null =>\n  snapshot && uiContext\n    ? {\n        ...snapshot,\n        ui: {\n          ...snapshot.ui,\n          ...uiContext,\n        },\n      }\n    : snapshot;\n\nconst getLauncherState = (launcher: SurveyAssistantThreadLauncher) => {\n  const state = launcherStates.get(launcher);\n  if (!state) {\n    throw new Error(\n      \"The survey assistant thread launcher was not created by createSurveyAssistantThreadLauncher.\",\n    );\n  }\n  return state;\n};\n\nconst drainPendingLaunches = async (state: LauncherState) => {\n  if (state.draining) return;\n  state.draining = true;\n  try {\n    while (state.handler && state.pending.length > 0) {\n      const pending = state.pending.shift();\n      if (!pending) continue;\n      try {\n        pending.resolve(await state.handler(pending.input));\n      } catch (error) {\n        pending.reject(error);\n      }\n    }\n  } finally {\n    state.draining = false;\n  }\n};\n\nexport const createSurveyAssistantThreadLauncher = (): SurveyAssistantThreadLauncher => {\n  const state: LauncherState = { handler: null, pending: [], draining: false };\n  const launcher: SurveyAssistantThreadLauncher = {\n    startThread(input) {\n      const prompt = input.prompt.trim();\n      if (!prompt && (input.files?.length ?? 0) === 0) {\n        return Promise.reject(new Error(\"A survey assistant prompt or attachment is required.\"));\n      }\n\n      return new Promise((resolve, reject) => {\n        state.pending.push({\n          input: {\n            ...input,\n            prompt,\n            ...(input.files ? { files: [...input.files] } : {}),\n            ...(input.modelId ? { modelId: input.modelId.trim() } : {}),\n            ...(input.title ? { title: input.title.trim() } : {}),\n          },\n          reject,\n          resolve,\n        });\n        void drainPendingLaunches(state);\n      });\n    },\n  };\n  launcherStates.set(launcher, state);\n  return launcher;\n};\n\nexport const connectSurveyAssistantThreadLauncher = (\n  launcher: SurveyAssistantThreadLauncher,\n  handler: LaunchHandler,\n) => {\n  const state = getLauncherState(launcher);\n  if (state.handler && state.handler !== handler) {\n    throw new Error(\"A survey assistant thread launcher can only control one mounted panel.\");\n  }\n  state.handler = handler;\n  void drainPendingLaunches(state);\n\n  return () => {\n    if (state.handler === handler) state.handler = null;\n  };\n};\n","import {\n  surveyAssistantSuggestResponseSettingsResultSchema,\n  type SurveyAssistantSuggestResponseSettingsInput,\n  type SurveyAssistantSuggestResponseSettingsResult,\n} from \"../protocol/tasks\";\nimport {\n  surveyAssistantSuggestResponseNameResultSchema,\n  surveyAssistantSuggestItemLabelResultSchema,\n  surveyAssistantTranslateContentResultSchema,\n  type SurveyAssistantSuggestResponseNameInput,\n  type SurveyAssistantSuggestResponseNameResult,\n  type SurveyAssistantSuggestItemLabelInput,\n  type SurveyAssistantSuggestItemLabelResult,\n  type SurveyAssistantTaskContext,\n  type SurveyAssistantTaskInvocationMode,\n  type SurveyAssistantTranslateContentInput,\n  type SurveyAssistantTranslateContentResult,\n} from \"../protocol\";\nimport { readSurveyAssistantJson } from \"./client-error\";\n\nexport interface SurveyAssistantTaskClientOptions {\n  api?: string;\n  resourceId?: string;\n  surveyId?: string;\n}\n\nexport interface SurveyAssistantTaskExecutionOptions {\n  mode?: SurveyAssistantTaskInvocationMode;\n  modelId?: string;\n  signal?: AbortSignal;\n}\n\nexport interface SurveyAssistantTaskClient {\n  suggestResponseSettings(\n    input: SurveyAssistantSuggestResponseSettingsInput,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutionOptions,\n  ): Promise<SurveyAssistantSuggestResponseSettingsResult>;\n  suggestResponseName(\n    input: SurveyAssistantSuggestResponseNameInput,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutionOptions,\n  ): Promise<SurveyAssistantSuggestResponseNameResult>;\n  suggestItemLabel(\n    input: SurveyAssistantSuggestItemLabelInput,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutionOptions,\n  ): Promise<SurveyAssistantSuggestItemLabelResult>;\n  translateContent(\n    input: SurveyAssistantTranslateContentInput,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutionOptions,\n  ): Promise<SurveyAssistantTranslateContentResult>;\n}\n\nexport const createSurveyAssistantTaskClient = ({\n  api = \"/api/survey-assistant/tasks\",\n  resourceId,\n  surveyId,\n}: SurveyAssistantTaskClientOptions = {}): SurveyAssistantTaskClient => {\n  const run = async (\n    taskId:\n      | \"suggest-response-settings\"\n      | \"suggest-response-name\"\n      | \"suggest-item-label\"\n      | \"translate-content\",\n    input: unknown,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutionOptions,\n  ) => {\n    const modelId = options?.modelId;\n    return readSurveyAssistantJson(\n      await fetch(api, {\n        body: JSON.stringify({\n          taskId,\n          input,\n          context,\n          ...(options?.mode ? { mode: options.mode } : {}),\n          ...(modelId ? { modelId } : {}),\n          ...(resourceId ? { resourceId } : {}),\n          ...(surveyId ? { surveyId } : {}),\n        }),\n        headers: { \"content-type\": \"application/json\" },\n        method: \"POST\",\n        signal: options?.signal,\n      }),\n      \"The survey assistant task could not be completed.\",\n    );\n  };\n\n  return {\n    async suggestResponseSettings(input, context, options) {\n      return surveyAssistantSuggestResponseSettingsResultSchema.parse(\n        await run(\"suggest-response-settings\", input, context, options),\n      );\n    },\n    async suggestResponseName(input, context, options) {\n      return surveyAssistantSuggestResponseNameResultSchema.parse(\n        await run(\"suggest-response-name\", input, context, options),\n      );\n    },\n    async suggestItemLabel(input, context, options) {\n      return surveyAssistantSuggestItemLabelResultSchema.parse(\n        await run(\"suggest-item-label\", input, context, options),\n      );\n    },\n    async translateContent(input, context, options) {\n      return surveyAssistantTranslateContentResultSchema.parse(\n        await run(\"translate-content\", input, context, options),\n      );\n    },\n  };\n};\n","import type { SurveyApplyResult, SurveyBatchApplyResult, SurveyChangeSet } from \"../protocol\";\nimport type { SurveyAssistantController } from \"./controller\";\n\nexport interface CreateSurveyAssistantControllerProxyOptions {\n  notReadyMessage?: string;\n}\n\nexport interface SurveyAssistantControllerBridge {\n  controller: SurveyAssistantController;\n  setController(controller: SurveyAssistantController | null | undefined): void;\n}\n\nconst failedResult = (change: SurveyChangeSet, message: string): SurveyApplyResult => ({\n  status: \"failed\",\n  changeId: change.id,\n  summary: change.summary,\n  message,\n  appliedOperations: 0,\n});\n\nexport const createSurveyAssistantControllerProxy = (\n  getController: () => SurveyAssistantController | null | undefined,\n  {\n    notReadyMessage = \"The survey editor is not ready.\",\n  }: CreateSurveyAssistantControllerProxyOptions = {},\n): SurveyAssistantController => ({\n  getSnapshot: () => getController()?.getSnapshot() ?? null,\n  applyAssistantChanges: (changes): SurveyBatchApplyResult => {\n    const controller = getController();\n    if (!controller) {\n      return { results: changes.map((change) => failedResult(change, notReadyMessage)) };\n    }\n    return controller.applyAssistantChanges(changes);\n  },\n});\n\nexport const createSurveyAssistantControllerBridge = (\n  options?: CreateSurveyAssistantControllerProxyOptions,\n): SurveyAssistantControllerBridge => {\n  let currentController: SurveyAssistantController | null | undefined;\n  return {\n    controller: createSurveyAssistantControllerProxy(() => currentController, options),\n    setController(controller) {\n      currentController = controller;\n    },\n  };\n};\n"],"mappings":"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"}