issue-sticker 0.3.0 → 0.4.0

package/dist/{tooltip-DciWyUWs.js → tooltip-CEc_RGfI.js}

@@ -1,6 +1,6 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
-import { h as Presence, n as Portal$1, w as Arrow, D as DismissableLayer, C as Content, y as Root, j as useComposedRefs, t as createPopperScope, i as createContextScope, z as createSlottable, f as useId, e as useControllableState, v as Root2, A as Anchor, P as Primitive, g as composeEventHandlers, b as usePortalContainer, a as cn, d as OVERLAY_LAYER, s as stopEscapePropagation } from "./createLucideIcon-CmSNiW63.js";
+import { h as Presence, n as Portal$1, w as Arrow, D as DismissableLayer, C as Content, y as Root, j as useComposedRefs, t as createPopperScope, i as createContextScope, z as createSlottable, f as useId, e as useControllableState, v as Root2, A as Anchor, P as Primitive, g as composeEventHandlers, b as usePortalContainer, a as cn, O as OVERLAY_LAYER, s as stopEscapePropagation } from "./createLucideIcon-C0Ldhp96.js";
 var [createTooltipContext] = createContextScope("Tooltip", [
   createPopperScope
 ]);

package/headless.d.ts

@@ -1,11 +1,118 @@
-import type {
-  Issue,
-  IssueFilterGroup,
-  IssueFilters,
-  IssuePosition,
-  IssueStickerSummary,
-  SessionReplayMeta,
-} from '@issue-sticker/shared';
+// 공개 타입은 이 파일 안에서 닫는다. 내부 패키지(@issue-sticker/shared)를 참조하면 배포
+// tarball 에 없는 모듈을 가리켜 소비자 tsc 가 깨지고, 딸려오는 백엔드 계약 전체가 함께
+// 노출된다. 구현과의 정합은 src/headless/publicTypes.conformance.ts 가 컴파일 타임에 지킨다.
+
+export interface IssuePosition {
+  x: number;
+  y: number;
+  selector: string;
+  xpath: string;
+  viewport?: {
+    width: number;
+    height: number;
+    scrollX?: number;
+    scrollY?: number;
+  };
+  elementRect?: {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+  };
+}
+
+export interface NetworkLog {
+  url: string;
+  method: string;
+  statusCode: number;
+  timestamp: number;
+  type: string;
+  duration?: number | null;
+  requestHeaders?: Record<string, string> | null;
+  responseHeaders?: Record<string, string> | null;
+  requestBody?: string | null;
+  requestBodySizeBytes?: number | null;
+  requestBodyOmittedReason?: string | null;
+  responseBody?: string | null;
+  responseBodyEncoding?: string | null;
+  responseBodySizeBytes?: number | null;
+  responseBodyOmittedReason?: string | null;
+  responseMimeType?: string | null;
+}
+
+export interface ConsoleLog {
+  type: 'log' | 'warning' | 'error' | 'info' | 'debug';
+  message: string;
+  timestamp: number;
+  args?: unknown[] | null;
+  url?: string | null;
+  lineNumber?: number | null;
+  columnNumber?: number | null;
+  stackTrace?: string | null;
+}
+
+/** 이슈에 연결된 외부 트래커(Jira·Notion) 매핑. 서비스별 메타데이터는 형태가 서비스에 달려 있어 `unknown` 으로 둔다. */
+export interface IssueExternalMapping {
+  id: string;
+  external_id: string;
+  service_type?: 'JIRA' | 'NOTION';
+  exposed_fields?: string[];
+  jira_issue_metadata?: unknown;
+  notion_page_metadata?: unknown;
+}
+
+/** 목록용 이슈. 마커를 그리는 데 필요한 필드만 담는다. */
+export interface IssueStickerSummary {
+  id: string;
+  project_id: string;
+  url: string;
+  title: string;
+  position: IssuePosition;
+  external_user_id?: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+/** 상세 조회한 이슈. */
+export interface Issue extends IssueStickerSummary {
+  description: string | null;
+  screenshot: string | string[] | null;
+  video: string | null;
+  user_agent: string | null;
+  external_user_name: string | null;
+  network_logs: NetworkLog[] | null;
+  console_logs: ConsoleLog[] | null;
+  issue_external_mappings?: IssueExternalMapping[];
+  project: { name: string } | null;
+  reporter: { display_name: string | null } | null;
+}
+
+/** 세션 리플레이 첨부 메타. */
+export interface SessionReplayMeta {
+  window_seconds: number;
+  event_count: number;
+  size_bytes: number;
+  rrweb_version: string;
+  privacy_config_version: string;
+  release?: string;
+  release_source?: string;
+}
+
+export interface IssueFilterOption {
+  label: string;
+  value: string;
+}
+
+export type IssueFilterGroup =
+  | {
+      kind: 'custom';
+      id: string;
+      fieldDefinitionId: string;
+      label: string;
+      options: IssueFilterOption[];
+    }
+  | { kind: 'jira'; id: string; fieldName: string; label: string; options: IssueFilterOption[] }
+  | { kind: 'notion'; id: string; fieldName: string; label: string; options: IssueFilterOption[] };
 
 export type HeadlessPhase =
   | 'initializing'
@@ -24,7 +131,8 @@ export type HeadlessErrorCode =
   | 'MEMBER_AUTH_REQUIRED'
   | 'NETWORK_ERROR'
   | 'CAPTURE_FAILED'
-  | 'VALIDATION_ERROR';
+  | 'VALIDATION_ERROR'
+  | 'PAYLOAD_TOO_LARGE';
 
 export type HeadlessAuthMode = 'public' | 'member';
 export type HeadlessCaptureMediaMode = 'screenshot' | 'video';
@@ -119,10 +227,12 @@ export interface HeadlessSessionReplayState {
 }
 
 export interface HeadlessSnapshot {
+  /** 익스텐션이 이 페이지의 런타임을 소유 중인가. true 면 SDK 는 아무것도 띄우지 않는다. */
+  readonly extensionActive: boolean;
   readonly phase: HeadlessPhase;
   readonly auth: HeadlessAuthState;
   readonly issues: readonly IssueStickerSummary[];
-  readonly activeIssue: (Issue & { comments?: unknown[] }) | null;
+  readonly activeIssue: Issue | null;
   readonly draft: HeadlessIssueDraft | null;
   readonly videoCapture: HeadlessVideoCaptureState;
   readonly sessionReplay: HeadlessSessionReplayState;
@@ -131,8 +241,29 @@ export interface HeadlessSnapshot {
   readonly error: IssueStickerHeadlessError | null;
 }
 
-export interface HeadlessIssueFilters extends Omit<IssueFilters, 'projectId' | 'externalUserId'> {
+export interface HeadlessIssueFilters {
+  /** 이슈 발생 URL. `'all'` 이면 URL 조건 없이 조회합니다. */
+  url?: string[] | string | 'all';
+  /** 이 사용자가 만든 이슈만 조회합니다. */
   externalUserId?: string;
+  /** 제목·URL substring 검색. */
+  search?: string;
+  /** ISO 8601 — 생성일 하한. */
+  dateFrom?: string;
+  /** ISO 8601 — 생성일 상한. */
+  dateTo?: string;
+  /** 1-based 페이지 번호. */
+  page?: number;
+  /** 페이지 크기 (1-500, 기본 100). */
+  pageSize?: number;
+  /** 커스텀 필드 ID → 선택 값 배열. */
+  customFieldValues?: Record<string, string[]>;
+  /** Jira 표준 필드 ID(예: `'status'`, `'assignee'`) → 선택 값 배열. */
+  jiraFieldValues?: Record<string, string[]>;
+  /** Notion 필드 ID → 선택 값 배열. */
+  notionFieldValues?: Record<string, string[]>;
+  /** 생성일 정렬 순서. 미지정 시 `'desc'`. */
+  sortOrder?: 'asc' | 'desc';
 }
 
 export interface SubmitDraftInput {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "issue-sticker",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "IssueSticker SDK - Visual bug tracking widget for web applications",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -23,9 +23,6 @@
       "require": "./dist/issue-sticker-headless-react.js",
       "default": "./dist/issue-sticker-headless-react.js"
     },
-    "./react.js": "./dist/issue-sticker-react.js",
-    "./headless.js": "./dist/issue-sticker-headless.js",
-    "./headless/react.js": "./dist/issue-sticker-headless-react.js",
     "./package.json": "./package.json"
   },
   "files": [

package/react.d.ts

@@ -3,7 +3,14 @@ export interface SDKUser {
   name: string;
 }
 
-export type OnboardingTrigger = 'off' | 'onMount' | 'onFABClick';
+export type OnboardingTrigger = 'off' | 'onMount';
+
+export type ToolbarCorner = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+
+export interface ToolbarConfig {
+  corner?: ToolbarCorner;
+  offset?: { x: number; y: number };
+}
 
 export interface SDKConfig {
   apiKey: string;
@@ -12,6 +19,7 @@ export interface SDKConfig {
     useWebWorker?: boolean;
   };
   onboarding?: OnboardingTrigger;
+  toolbar?: ToolbarConfig;
 }
 
 export type SDKEvent =