anton-bakker-feedback 0.1.0

package/dist/core/i18n.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Internationalisation utilities for the feedback package.
+ *
+ * t() falls back gracefully:
+ *   - Unknown locale → English
+ *   - Unknown key → returns the key itself (never undefined)
+ *
+ * Template interpolation: {{param}} → replaced with params values
+ */
+/** Supported locale codes */
+export declare const SUPPORTED_LOCALES: readonly string[];
+/** Default locale when unknown locale is requested */
+export declare const DEFAULT_LOCALE = "en";
+/**
+ * Looks up a translation key.
+ *
+ * Fallback chain:
+ *   1. customTranslations[locale][key]
+ *   2. BUILT_IN_TRANSLATIONS[locale][key]
+ *   3. BUILT_IN_TRANSLATIONS['en'][key]
+ *   4. key itself (never returns undefined or throws)
+ *
+ * Template interpolation: {{days}} → params.days (if params provided)
+ *
+ * @param key - Dot-notation key e.g. 'feedback.button.open'
+ * @param locale - BCP 47 locale code e.g. 'en', 'nl'
+ * @param customTranslations - Optional custom translations (overrides built-in)
+ * @param params - Optional template parameters e.g. { days: 7 }
+ */
+export declare function t(key: string, locale: string, customTranslations?: Record<string, Record<string, string>>, params?: Record<string, string | number>): string;
+/**
+ * Returns the locale to use.
+ * If preferredLocale is a supported locale → return it.
+ * Otherwise → return DEFAULT_LOCALE ('en').
+ *
+ * @param preferredLocale - BCP 47 locale code or undefined
+ */
+export declare function detectLocale(preferredLocale?: string): string;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/core/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/core/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAA0B,CAAC;AAE1E,sDAAsD;AACtD,eAAO,MAAM,cAAc,OAAO,CAAC;AAYnC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,CAAC,CACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC3D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvC,MAAM,CAgCR;AAoBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7D"}

package/dist/core/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Core barrel — re-exports everything from all core modules.
+ * This is the single import point for other slices.
+ *
+ * Usage: import { StoredFeedbackItem, processFeedbackCapture, t } from 'anton-bakker-feedback'
+ */
+export * from './types.js';
+export * from './config.js';
+export * from './capture.js';
+export * from './transport.js';
+export * from './validation.js';
+export * from './transforms.js';
+export * from './observability.js';
+export * from './i18n.js';
+export * from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/core/locales/en.d.ts

@@ -0,0 +1,6 @@
+/**
+ * English (en) translations for the feedback package.
+ * Key format: feedback.{component}.{element}
+ */
+export declare const en: Record<string, string>;
+//# sourceMappingURL=en.d.ts.map

package/dist/core/locales/en.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../src/core/locales/en.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiDrC,CAAC"}

package/dist/core/locales/nl.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Dutch (nl) translations for the feedback package.
+ * Key format: feedback.{component}.{element}
+ */
+export declare const nl: Record<string, string>;
+//# sourceMappingURL=nl.d.ts.map

package/dist/core/locales/nl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nl.d.ts","sourceRoot":"","sources":["../../../src/core/locales/nl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiDrC,CAAC"}

package/dist/core/observability.d.ts

@@ -0,0 +1,54 @@
+/**
+ * OpenTelemetry span helpers with zero AWS dependencies.
+ *
+ * @opentelemetry/api is declared as an optional peer dependency.
+ * If the consuming app has it installed, traces are emitted.
+ * If not, functions degrade gracefully to no-ops.
+ *
+ * CRITICAL: No hard import of '@opentelemetry/api' — only dynamic import.
+ * Dynamic import used for runtime availability check.
+ */
+interface OtelSpan {
+    setStatus(status: {
+        code: number;
+        message?: string;
+    }): void;
+    recordException(exception: Error): void;
+    end(): void;
+}
+/**
+ * Initialise the OTel tracer singleton.
+ * Idempotent — calling twice with the same appName is a no-op.
+ * Safe to call when @opentelemetry/api is not installed (no-op).
+ */
+export declare function initTracer(appName: string): void;
+/**
+ * Wraps an async operation in an OTel span.
+ * If OTel is unavailable or initTracer not called → runs operation without span.
+ * The span argument passed to the operation callback is null when OTel is unavailable.
+ *
+ * Span name convention: feedback.{operation} (e.g., feedback.submit, feedback.dialogue)
+ * Required attributes: app (appName), environment, feedbackId (when available)
+ */
+export declare function withSpan<T>(operationName: string, attributes: Record<string, string | number | boolean>, operation: (span: OtelSpan | null) => Promise<T>): Promise<T>;
+/**
+ * Records a feedback submission span event.
+ * No-op when OTel unavailable.
+ */
+export declare function recordSubmitEvent(feedbackId: string, appName: string, environment?: string): void;
+/**
+ * Records a dialogue exchange span event.
+ * No-op when OTel unavailable.
+ */
+export declare function recordDialogueExchange(feedbackId: string, turnNumber: number, appName: string): void;
+/**
+ * Emits a metric to CloudWatch (fire-and-forget).
+ *
+ * Only active when process.env.AWS_REGION is set AND
+ * @aws-sdk/client-cloudwatch is importable at runtime (dynamic import).
+ * If either condition is absent, logs to console.debug instead.
+ * NEVER throws.
+ */
+export declare function emitMetric(metricName: string, value: number, unit: 'Count' | 'Milliseconds' | 'Bytes', dimensions: Record<string, string>): void;
+export {};
+//# sourceMappingURL=observability.d.ts.map

package/dist/core/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/core/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,UAAU,QAAQ;IAChB,SAAS,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,eAAe,CAAC,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;IACxC,GAAG,IAAI,IAAI,CAAC;CACb;AAaD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAoBhD;AASD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACrD,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAC/C,OAAO,CAAC,CAAC,CAAC,CAqBZ;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAUN;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,IAAI,CAUN;AAMD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,OAAO,EACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,IAAI,CAmCN"}

package/dist/core/transforms.d.ts

@@ -0,0 +1,57 @@
+import { FeedbackType, FeedbackStatus, StoredFeedbackItem, CorrectionEntry } from './types.js';
+
+/** The six DynamoDB keys for a feedback item */
+export interface FeedbackKeys {
+    PK: string;
+    SK: string;
+    GSI1PK: string;
+    GSI1SK: string;
+    GSI2PK: string;
+    GSI2SK: string;
+}
+/**
+ * Builds the six DynamoDB keys for a feedback item.
+ *
+ * @param appName - Application name (e.g. 'sagrosoft20')
+ * @param id - Feedback ID (e.g. 'FB-2026-07-25-abc12345')
+ * @param type - Feedback type
+ * @param status - Current status
+ * @param priority - Priority score 0–100
+ * @param timestamp - ISO 8601 timestamp
+ */
+export declare function buildKeys(appName: string, id: string, type: FeedbackType, status: FeedbackStatus, priority: number, timestamp: string): FeedbackKeys;
+/**
+ * Extracts timestamp and id from a composite SK.
+ * SK format: FB#{timestamp}#{id}
+ */
+export declare function parseSK(sk: string): {
+    timestamp: string;
+    id: string;
+};
+/**
+ * Parses the GSI2PK into its component parts.
+ * GSI2PK format: TYPE#{type}#PROJECT#{appName}
+ */
+export declare function parseGSI2PK(gsi2pk: string): {
+    type: FeedbackType;
+    appName: string;
+};
+/**
+ * Adds a reporter to an item.
+ * Returns new reporters array and updated reporterCount — does NOT mutate original.
+ */
+export declare function addReporter(item: StoredFeedbackItem, userId: string, addedContext?: string, nowIso?: string): Pick<StoredFeedbackItem, 'reporters' | 'reporterCount' | 'GSI1SK'>;
+/**
+ * Appends a correction record to the corrections array.
+ * Returns a new array — does NOT mutate the original.
+ */
+export declare function appendCorrection(corrections: CorrectionEntry[], correction: Omit<CorrectionEntry, 'correctedAt'>, nowIso?: string): CorrectionEntry[];
+/**
+ * Applies a status transition to an item.
+ * Returns updated key fields + lastModifiedAt (does NOT mutate original).
+ *
+ * When transitioning to 'resolved': sets resolvedAt = nowIso.
+ * When transitioning to any other status: resolvedAt is undefined.
+ */
+export declare function applyStatusTransition(item: StoredFeedbackItem, newStatus: FeedbackStatus, nowIso?: string): Pick<StoredFeedbackItem, 'status' | 'GSI1PK' | 'GSI1SK' | 'lastModifiedAt' | 'resolvedAt' | 'resolvedBy'>;
+//# sourceMappingURL=transforms.d.ts.map

package/dist/core/transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../src/core/transforms.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAMpB,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,YAAY,CAad;AAMD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAYrE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAYnF;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,eAAe,GAAG,QAAQ,CAAC,CAmBpE;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,eAAe,EAAE,EAC9B,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,EAChD,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,EAAE,CAMnB;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE,cAAc,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CACL,kBAAkB,EAClB,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,gBAAgB,GAAG,YAAY,GAAG,YAAY,CAChF,CAmBA"}

package/dist/core/transport.d.ts

@@ -0,0 +1,44 @@
+import { StoredFeedbackItem, SubmitResult, DialogueResponse, UploadResult, DialogueEntry } from './types.js';
+
+/** What the React adapter calls at submit time */
+export interface FeedbackSubmitTransport {
+    submit(item: StoredFeedbackItem): Promise<SubmitResult>;
+}
+/** What the dialogue UI calls on each exchange */
+export interface FeedbackDialogueTransport {
+    exchange(feedbackId: string, message: string, history: DialogueEntry[]): Promise<DialogueResponse>;
+}
+/** What the screenshot capture calls after html2canvas */
+export interface FeedbackScreenshotTransport {
+    upload(feedbackId: string, blob: Blob): Promise<UploadResult>;
+}
+/**
+ * Composite transport — all three combined for full-feature transport.
+ * Dialogue and screenshot are optional so implementations can omit them.
+ */
+export interface FeedbackTransport extends FeedbackSubmitTransport, Partial<FeedbackDialogueTransport>, Partial<FeedbackScreenshotTransport> {
+}
+/** Memory transport with access to internal state for assertions */
+export interface MemoryTransport extends FeedbackTransport {
+    /** All submitted items */
+    submissions: StoredFeedbackItem[];
+    /** Queue of dialogue responses to return in order */
+    dialogueResponses: DialogueResponse[];
+    /** Uploaded screenshot blobs */
+    uploadedScreenshots: Array<{
+        feedbackId: string;
+        blob: Blob;
+    }>;
+    /** Clear all stored state */
+    clear(): void;
+}
+/**
+ * Creates an in-memory transport for testing.
+ *
+ * - submit(): stores the item and returns { success: true, feedbackId: item.id }
+ * - exchange(): returns the first queued response, or a default stub
+ * - upload(): records the blob reference
+ * - Does NOT import any AWS SDK
+ */
+export declare function createMemoryTransport(): MemoryTransport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/core/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/core/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAMpB,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACzD;AAED,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EAAE,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B;AAED,0DAA0D;AAC1D,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC/D;AAED;;;GAGG;AACH,MAAM,WAAW,iBACf,SAAQ,uBAAuB,EAC7B,OAAO,CAAC,yBAAyB,CAAC,EAClC,OAAO,CAAC,2BAA2B,CAAC;CAAG;AAM3C,oEAAoE;AACpE,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,0BAA0B;IAC1B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,qDAAqD;IACrD,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,gCAAgC;IAChC,mBAAmB,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IAC/D,6BAA6B;IAC7B,KAAK,IAAI,IAAI,CAAC;CACf;AAQD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CA2CvD"}

package/dist/core/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Core type definitions for the anton-bakker-feedback package.
+ *
+ * ZERO IMPORTS — this file is the single source of truth for all data types.
+ * Every other module imports from this file; this file imports nothing.
+ */
+/** Type of feedback being submitted */
+export type FeedbackType = 'bug' | 'feature' | 'ux' | 'other';
+/**
+ * Lifecycle status of a feedback item.
+ * Exactly: 'open' | 'approved' | 'deferred' | 'resolved' | 'wontfix'
+ */
+export type FeedbackStatus = 'open' | 'approved' | 'deferred' | 'resolved' | 'wontfix';
+/** Scope of the feedback issue */
+export type FeedbackScope = 'isolated' | 'cross-cutting' | 'systemic';
+/** Estimated size/effort for the feedback item */
+export type FeedbackSize = 'trivial' | 'small' | 'medium' | 'large';
+/** Environment where feedback was submitted */
+export type FeedbackEnvironment = 'development' | 'staging' | 'production';
+/** A reporter who submitted or upvoted a feedback item */
+export interface Reporter {
+    userId: string;
+    addedAt: string;
+    addedContext?: string;
+}
+/** A single dialogue turn between user and assistant */
+export interface DialogueEntry {
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: string;
+}
+/** A correction record tracking field changes */
+export interface CorrectionEntry {
+    field: string;
+    before: unknown;
+    after: unknown;
+    correctedBy: string;
+    correctedAt: string;
+    reason?: string;
+}
+/** Browser and server context captured at submission time */
+export interface FeedbackContext {
+    url: string;
+    pageTitle?: string;
+    userAgent?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    locale?: string;
+    timezone?: string;
+    performanceMs?: number;
+    consoleErrors?: string[];
+    customFields?: Record<string, string | number | boolean>;
+}
+/**
+ * The canonical DynamoDB row for a feedback item.
+ *
+ * Key patterns (must match 01-shared-infrastructure exactly):
+ *   PK:     PROJECT#{appName}
+ *   SK:     FB#{isoTimestamp}#{id}
+ *   GSI1PK: STATUS#{status}
+ *   GSI1SK: {inverted-priority-padded}#{id}
+ *   GSI2PK: TYPE#{type}#PROJECT#{appName}
+ *   GSI2SK: {isoTimestamp}
+ */
+export interface StoredFeedbackItem {
+    PK: string;
+    SK: string;
+    GSI1PK: string;
+    GSI1SK: string;
+    GSI2PK: string;
+    GSI2SK: string;
+    id: string;
+    appName: string;
+    type: FeedbackType;
+    status: FeedbackStatus;
+    scope?: FeedbackScope;
+    size?: FeedbackSize;
+    priority: number;
+    content: string;
+    context: FeedbackContext;
+    classification?: string;
+    hasScreenshot: boolean;
+    screenshotS3Key?: string;
+    submittedAt: string;
+    lastModifiedAt: string;
+    resolvedAt?: string;
+    resolvedBy?: string;
+    submittedBy: string;
+    assignedTo?: string;
+    reporters: Reporter[];
+    reporterCount: number;
+    dialogueHistory: DialogueEntry[];
+    corrections: CorrectionEntry[];
+    environment?: FeedbackEnvironment;
+    version?: string;
+    tags: string[];
+    traceId?: string;
+    linkedCommit?: string;
+}
+/** Result of a feedback submission */
+export interface SubmitResult {
+    success: boolean;
+    feedbackId: string;
+    error?: string;
+    retryable?: boolean;
+}
+/** Response from a dialogue exchange */
+export interface DialogueResponse {
+    success: boolean;
+    response?: string;
+    conversationComplete?: boolean;
+    classificationSuggested?: Partial<Pick<StoredFeedbackItem, 'type' | 'scope' | 'size'>>;
+    error?: string;
+}
+/** Result of a screenshot upload */
+export interface UploadResult {
+    success: boolean;
+    s3Key?: string;
+    error?: string;
+}
+/** OpenTelemetry tracing context */
+export interface TracingContext {
+    traceId: string;
+    spanId: string;
+    spanName: string;
+    startTimeMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/validation.d.ts

@@ -0,0 +1,48 @@
+import { FeedbackContext } from './types.js';
+import { CaptureInput } from './capture.js';
+
+/** Immutable validation constants */
+export declare const VALIDATION_RULES: {
+    readonly CONTENT_MIN_LENGTH: 10;
+    readonly CONTENT_MAX_LENGTH: 5000;
+    readonly TAG_MAX_COUNT: 10;
+    readonly TAG_PATTERN: RegExp;
+    readonly APP_NAME_PATTERN: RegExp;
+    readonly SCREENSHOT_MAX_BYTES: 5242880;
+    readonly CONSOLE_ERRORS_MAX: 20;
+};
+/** Validation result with user-facing messages */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validates feedback content.
+ * Fails below CONTENT_MIN_LENGTH ("Feedback must be at least 10 characters"),
+ * fails above CONTENT_MAX_LENGTH, warns if only whitespace.
+ */
+export declare function validateContent(content: string): ValidationResult;
+/**
+ * Validates feedback tags.
+ * Fails if count exceeds TAG_MAX_COUNT or if any tag doesn't match TAG_PATTERN.
+ */
+export declare function validateTags(tags: string[]): ValidationResult;
+/**
+ * Validates an app name.
+ */
+export declare function validateAppName(appName: string): ValidationResult;
+/**
+ * Validates screenshot size.
+ */
+export declare function validateScreenshotSize(sizeBytes: number): ValidationResult;
+/**
+ * Validates browser context.
+ * Warns if url is empty; warns if consoleErrors exceeds 20 items.
+ */
+export declare function validateContext(context: FeedbackContext): ValidationResult;
+/**
+ * Aggregate validator — runs all validators for a capture input.
+ */
+export declare function validateCaptureInput(input: Partial<CaptureInput>): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD,qCAAqC;AACrC,eAAO,MAAM,gBAAgB;;;;;;;;CAQnB,CAAC;AAMX,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAUD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAiBjE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAmB7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAajE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAW1E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAkB1E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,gBAAgB,CAiCnF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './core/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC"}