issue-sticker 0.3.1 → 0.5.0

package/dist/{tooltip-DciWyUWs.js → tooltip-B6UPO-U8.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 { P as Presence, i as Portal$1, w as Arrow, D as DismissableLayer, C as Content, y as Root, h as useComposedRefs, t as createPopperScope, j as createContextScope, z as createSlottable, m as useId, l as useControllableState, v as Root2, A as Anchor, e as Primitive, f as composeEventHandlers, b as usePortalContainer, a as cn, O as OVERLAY_LAYER, s as stopEscapePropagation } from "./createLucideIcon-BzRMP02h.js";
 var [createTooltipContext] = createContextScope("Tooltip", [
   createPopperScope
 ]);

package/headless.d.ts

@@ -82,7 +82,6 @@ export interface Issue extends IssueStickerSummary {
   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;
@@ -132,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';
@@ -227,6 +227,8 @@ export interface HeadlessSessionReplayState {
 }
 
 export interface HeadlessSnapshot {
+  /** 익스텐션이 이 페이지의 런타임을 소유 중인가. true 면 SDK 는 아무것도 띄우지 않는다. */
+  readonly extensionActive: boolean;
   readonly phase: HeadlessPhase;
   readonly auth: HeadlessAuthState;
   readonly issues: readonly IssueStickerSummary[];
@@ -265,11 +267,25 @@ export interface HeadlessIssueFilters {
 }
 
 export interface SubmitDraftInput {
-  title: string;
-  description: string;
+  /** intent 를 보내면 생략할 수 있다 — 서버가 생성한다. */
+  title?: string;
+  /** intent 를 보내면 생략할 수 있다 — 서버가 생성한다. */
+  description?: string;
+  /** 기대한 동작(To-be) 원문. 서버가 제목·설명을 비동기로 생성한다. */
+  intent?: string;
   dynamicFields?: Record<string, unknown>;
 }
 
+/**
+ * createIssue에 전달하는 입력. 유저 액션 없이 코드 조건으로 이슈를 만들 때 씁니다.
+ */
+export interface CreateIssueInput extends SubmitDraftInput {
+  /** 이슈를 붙일 요소. 기본값은 `document.body`(문서 좌상단). */
+  readonly target?: HTMLElement;
+  /** 기본 `'screenshot'`. `'none'`이면 캡처를 건너뛰고 즉시 전송합니다. */
+  readonly media?: 'screenshot' | 'none';
+}
+
 export interface HeadlessClient {
   readonly phase: HeadlessPhase;
   getSnapshot(): HeadlessSnapshot;
@@ -285,6 +301,17 @@ export interface HeadlessClient {
   setSessionReplayEnabled(enabled: boolean): void;
   cancelIssueCapture(): void;
   submitDraft(input: SubmitDraftInput): Promise<Issue>;
+  /**
+   * 유저 액션 없이 코드에서 이슈를 만듭니다. 캡처 단계를 거치지 않으므로 `phase`와
+   * `draft`를 건드리지 않고, 사용자가 이슈를 작성하는 중에도 호출할 수 있습니다.
+   *
+   * 실패해도 예외를 던지지 않고 `null`을 돌려줍니다. 이미 오류를 처리하는 자리에서
+   * 부르는 메서드라, 이슈 생성만을 위한 try/catch 를 한 겹 더 쓰지 않아도 됩니다.
+   * 실패 사유는 콘솔 경고로 남습니다.
+   *
+   * 호출 조건이 잘못 잡히면 이슈가 무한히 쌓이므로 SDK가 60초 5건으로 제한합니다.
+   */
+  createIssue(input: CreateIssueInput): Promise<Issue | null>;
   loginAsMember(): Promise<void>;
   logoutMember(): Promise<void>;
   destroy(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "issue-sticker",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "IssueSticker SDK - Visual bug tracking widget for web applications",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -56,13 +56,14 @@
     "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",
+    "typecheck": "npm run tsc && npm run tsc:examples",
     "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",
     "tsc": "tsc --noEmit",
+    "tsc:examples": "tsc --noEmit -p tsconfig.examples.json",
     "tsc:watch": "tsc --noEmit --watch",
     "test:e2e": "playwright test",
     "test:e2e:ui": "playwright test --ui"

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 =