issue-sticker 0.2.2 → 0.3.1

package/dist/{tooltip-BkQcdrki.js → tooltip-DciWyUWs.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, O as OVERLAY_LAYER, s as stopEscapePropagation } from "./createLucideIcon-B457EluY.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, d as OVERLAY_LAYER, s as stopEscapePropagation } from "./createLucideIcon-CmSNiW63.js";
 var [createTooltipContext] = createContextScope("Tooltip", [
   createPopperScope
 ]);

package/headless.d.ts

@@ -1,11 +1,119 @@
-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;
+  comments?: unknown[];
+  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'
@@ -122,7 +230,7 @@ export interface HeadlessSnapshot {
   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 +239,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.2.2",
+  "version": "0.3.1",
   "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": [
@@ -58,6 +55,10 @@
     "serve:demo": "vite --host 0.0.0.0 --port 4174 --mode demo",
     "serve:localdev": "vite --host 0.0.0.0 --port 4173 --mode localdev",
     "preview": "vite preview",
+    "lint": "cd ../.. && eslint packages/sdk --ext .ts,.tsx,.js,.jsx",
+    "typecheck": "npm run tsc",
+    "format": "cd ../.. && prettier --write packages/sdk --ignore-unknown",
+    "format:check": "cd ../.. && prettier --check packages/sdk --ignore-unknown",
     "test": "vitest --run",
     "test:watch": "vitest",
     "test:ui": "vitest --ui",