@beezping/adapter-prisma 0.7.0 → 0.8.0

package/README.md

@@ -1,12 +1,12 @@
 [![npm version](https://img.shields.io/npm/v/@beezping/adapter-prisma)](https://www.npmjs.com/package/@beezping/adapter-prisma)
-[![Docs](https://img.shields.io/badge/docs-siteping.dev-0066ff)](https://siteping.dev/docs/adapters/prisma)
+[![Docs](https://img.shields.io/badge/docs-github.com/guidomodarelli/beezping-0066ff)](https://github.com/guidomodarelli/beezping/tree/main/apps/demo/content/docs/adapters/prisma.mdx)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
 
 # @beezping/adapter-prisma
 
-The production server adapter for [SitePing](https://github.com/NeosiaNexus/SitePing) — one endpoint that validates, authenticates, and persists client feedback in your database.
+The production server adapter for [Beezping](https://github.com/guidomodarelli/beezping) — one endpoint that validates, authenticates, and persists client feedback in your database.
 
-**[Documentation](https://siteping.dev/docs/adapters/prisma)** · **[live demo](https://siteping.dev/demo)**
+**[Documentation](https://github.com/guidomodarelli/beezping/tree/main/apps/demo/content/docs/adapters/prisma.mdx)** · **[live demo](https://github.com/guidomodarelli/beezping/tree/main/apps/demo)**
 
 ## Install
 
@@ -14,18 +14,18 @@ The production server adapter for [SitePing](https://github.com/NeosiaNexus/Site
 npm install @beezping/adapter-prisma
 ```
 
-**Peer dependency:** `@prisma/client` ^5 || ^6 || ^7 · Node ≥ 20.
+**Optional peer dependency:** `@prisma/client` ^5 || ^6 || ^7, needed only for the `prisma` option · Node ≥ 20.
 
 ## Quick start
 
 ```ts
-// app/api/siteping/route.ts — Next.js App Router
-import { createSitepingHandler } from "@beezping/adapter-prisma";
+// app/api/beezping/route.ts — Next.js App Router
+import { createBeezpingHandler } from "@beezping/adapter-prisma";
 import { prisma } from "@/lib/prisma";
 
-export const { GET, POST, PATCH, DELETE, OPTIONS } = createSitepingHandler({
+export const { GET, POST, PATCH, DELETE, OPTIONS } = createBeezpingHandler({
   prisma,
-  apiKey: process.env.SITEPING_API_KEY,        // Bearer auth
+  apiKey: process.env.BEEZPING_API_KEY,        // Bearer auth
   allowedOrigins: ["https://my-site.com"],     // exact-match CORS
 });
 ```
@@ -37,12 +37,12 @@ The handlers are Web-standard `Request` → `Response` — mount them from any f
 - **Safe by default** — status changes and deletes require the `apiKey`; in production the factory refuses to start without one. Author emails are redacted for unauthenticated readers and `clientId` never leaves the server
 - **Screenshot storage hook** — upload images to S3/R2/GCS instead of inlining data URLs
 - **Webhooks** — Slack, Discord, or generic POST on each new feedback (5 s timeout, never blocks the submission)
-- **Any store behind the same HTTP surface** — pass `store` instead of `prisma` to mount an in-memory or custom store with identical validation and auth
+- **Built on [`@beezping/server`](https://github.com/guidomodarelli/beezping/tree/main/apps/demo/content/docs/server.mdx)** — every server option works here too (custom `access`, lifecycle hooks, `waitUntil`…), and a non-Prisma store can mount through `@beezping/server` alone
 
 ## Documentation
 
-All options with their real defaults, the full HTTP reference (bodies, query params, errors, validation limits), the exact Prisma schema, and the security model: **[siteping.dev/docs/adapters/prisma](https://siteping.dev/docs/adapters/prisma)**.
+The Prisma options, the exact Prisma schema and screenshot storage: **[github.com/guidomodarelli/beezping/docs/adapters/prisma](https://github.com/guidomodarelli/beezping/tree/main/apps/demo/content/docs/adapters/prisma.mdx)**. The security model and the full HTTP reference (bodies, query params, errors, validation limits): **[github.com/guidomodarelli/beezping/docs/server](https://github.com/guidomodarelli/beezping/tree/main/apps/demo/content/docs/server.mdx)**.
 
 ## License
 
-[MIT](https://github.com/NeosiaNexus/SitePing/blob/main/LICENSE)
+[MIT](https://github.com/guidomodarelli/beezping/blob/main/LICENSE)

package/dist/beezping-core.d.cts

@@ -0,0 +1,20 @@
+export { settleWithConcurrencyLimit } from "./concurrency.cjs";
+export { buildDeepLink, parseHttpUrl } from "./deep-link.cjs";
+export { EMAIL_PATTERN, isValidEmail } from "./email.cjs";
+export type { BeezpingErrorCode } from "./errors.cjs";
+export { BeezpingAuthError, BeezpingError, BeezpingNetworkError, BeezpingValidationError } from "./errors.cjs";
+export type { FilterResult, Pagination } from "./filters.cjs";
+export { applyFeedbackFilters, clampPagination, DEFAULT_PAGE_LIMIT, isUnreachableOffset, MAX_PAGE_LIMIT, matchesFeedbackQuery, } from "./filters.cjs";
+export type { I18n, LocaleLoaders, TranslateFunction } from "./i18n.cjs";
+export { canonicalizeLocale, createI18n, interpolate, intlLocale, tWithParams } from "./i18n.cjs";
+export type { BeezpingModelFieldName, BeezpingModelName, FieldDef, IndexDef, ModelDef, PrismaNativeType, PrismaScalarType, RelationDef, RelationKind, RelationOnDelete, } from "./schema.cjs";
+export { BEEZPING_MODELS, isRelationField, isScalarField } from "./schema.cjs";
+export type { ScreenshotStorage } from "./screenshot-storage.cjs";
+export { SCREENSHOT_DELETE_CONCURRENCY, screenshotMimeType } from "./screenshot-storage.cjs";
+export type { CollectionStore, CollectionStoreBackend } from "./store-helpers.cjs";
+export { buildAnnotationRecord, buildCommentRecord, buildFeedbackRecord, createCollectionStore, } from "./store-helpers.cjs";
+export type { AssertEqual, IfEquals, Prettify, Serialized } from "./type-utils.cjs";
+export { hasOwn, isRecord } from "./type-utils.cjs";
+export type { AnchorData, AnnotationCreateInput, AnnotationPayload, AnnotationRecord, AnnotationResponse, BeezpingBaseConfig, BeezpingCapabilities, BeezpingConfig, BeezpingDeepLinkOptions, BeezpingHeadersOption, BeezpingHttpConfig, BeezpingIdentity, BeezpingInstance, BeezpingLocale, BeezpingPanelAction, BeezpingPanelActionContext, BeezpingPanelActionFeedback, BeezpingPanelButtonAction, BeezpingPanelLinkAction, BeezpingPosition, BeezpingPublicEventListener, BeezpingPublicEvents, BeezpingSkipReason, BeezpingStore, BeezpingStoreConfig, BeezpingTheme, BeezpingUnsubscribe, BuiltinLocale, ClosedFeedbackStatus, CommentAuthorRole, CommentCreateInput, CommentDeletePayload, CommentPayload, CommentRecord, CommentResponse, ConsoleDiagnosticEntry, ConsoleDiagnosticLevel, DiagnosticsCaptureOptions, DiagnosticsSnapshot, FeedbackCreateInput, FeedbackCreateOutcome, FeedbackListPermissions, FeedbackPage, FeedbackPayload, FeedbackPermissions, FeedbackQuery, FeedbackRecord, FeedbackResponse, FeedbackResponseList, FeedbackStatus, FeedbackType, FeedbackUpdateInput, NetworkDiagnosticEntry, OpenFeedbackStatus, PageScope, RectData, ScreenshotRegion, } from "./types.cjs";
+export { ANCHOR_ELEMENT_ID_MAX, ANCHOR_ELEMENT_TAG_MAX, BUILTIN_LOCALES, CLOSED_FEEDBACK_STATUSES, COMMENT_AUTHOR_ROLES, COMMENT_BODY_MAX_LENGTH, CONSOLE_DIAGNOSTIC_LEVELS, FEEDBACK_STATUSES, FEEDBACK_TYPES, flattenAnnotation, IDENTITY_FIELD_MAX_LENGTH, isClosedStatus, isStoreDuplicate, isStoreLimit, isStoreNotFound, isStorePersistence, isStoreValueTooLong, MAX_COMMENTS_PER_FEEDBACK, OPEN_FEEDBACK_STATUSES, StoreDuplicateError, StoreLimitError, StoreNotFoundError, StorePersistenceError, StoreValueTooLongError, toFeedbackUpdate, } from "./types.cjs";
+export { errorFromResponse, feedbackQueryToSearchParams, isCommentGone, isThreadFull, mergeRequestHeaders, networkErrorFromException, newClientId, withSearchParams, } from "./wire.cjs";

package/dist/beezping-core.d.ts

@@ -0,0 +1,20 @@
+export { settleWithConcurrencyLimit } from "./concurrency.js";
+export { buildDeepLink, parseHttpUrl } from "./deep-link.js";
+export { EMAIL_PATTERN, isValidEmail } from "./email.js";
+export type { BeezpingErrorCode } from "./errors.js";
+export { BeezpingAuthError, BeezpingError, BeezpingNetworkError, BeezpingValidationError } from "./errors.js";
+export type { FilterResult, Pagination } from "./filters.js";
+export { applyFeedbackFilters, clampPagination, DEFAULT_PAGE_LIMIT, isUnreachableOffset, MAX_PAGE_LIMIT, matchesFeedbackQuery, } from "./filters.js";
+export type { I18n, LocaleLoaders, TranslateFunction } from "./i18n.js";
+export { canonicalizeLocale, createI18n, interpolate, intlLocale, tWithParams } from "./i18n.js";
+export type { BeezpingModelFieldName, BeezpingModelName, FieldDef, IndexDef, ModelDef, PrismaNativeType, PrismaScalarType, RelationDef, RelationKind, RelationOnDelete, } from "./schema.js";
+export { BEEZPING_MODELS, isRelationField, isScalarField } from "./schema.js";
+export type { ScreenshotStorage } from "./screenshot-storage.js";
+export { SCREENSHOT_DELETE_CONCURRENCY, screenshotMimeType } from "./screenshot-storage.js";
+export type { CollectionStore, CollectionStoreBackend } from "./store-helpers.js";
+export { buildAnnotationRecord, buildCommentRecord, buildFeedbackRecord, createCollectionStore, } from "./store-helpers.js";
+export type { AssertEqual, IfEquals, Prettify, Serialized } from "./type-utils.js";
+export { hasOwn, isRecord } from "./type-utils.js";
+export type { AnchorData, AnnotationCreateInput, AnnotationPayload, AnnotationRecord, AnnotationResponse, BeezpingBaseConfig, BeezpingCapabilities, BeezpingConfig, BeezpingDeepLinkOptions, BeezpingHeadersOption, BeezpingHttpConfig, BeezpingIdentity, BeezpingInstance, BeezpingLocale, BeezpingPanelAction, BeezpingPanelActionContext, BeezpingPanelActionFeedback, BeezpingPanelButtonAction, BeezpingPanelLinkAction, BeezpingPosition, BeezpingPublicEventListener, BeezpingPublicEvents, BeezpingSkipReason, BeezpingStore, BeezpingStoreConfig, BeezpingTheme, BeezpingUnsubscribe, BuiltinLocale, ClosedFeedbackStatus, CommentAuthorRole, CommentCreateInput, CommentDeletePayload, CommentPayload, CommentRecord, CommentResponse, ConsoleDiagnosticEntry, ConsoleDiagnosticLevel, DiagnosticsCaptureOptions, DiagnosticsSnapshot, FeedbackCreateInput, FeedbackCreateOutcome, FeedbackListPermissions, FeedbackPage, FeedbackPayload, FeedbackPermissions, FeedbackQuery, FeedbackRecord, FeedbackResponse, FeedbackResponseList, FeedbackStatus, FeedbackType, FeedbackUpdateInput, NetworkDiagnosticEntry, OpenFeedbackStatus, PageScope, RectData, ScreenshotRegion, } from "./types.js";
+export { ANCHOR_ELEMENT_ID_MAX, ANCHOR_ELEMENT_TAG_MAX, BUILTIN_LOCALES, CLOSED_FEEDBACK_STATUSES, COMMENT_AUTHOR_ROLES, COMMENT_BODY_MAX_LENGTH, CONSOLE_DIAGNOSTIC_LEVELS, FEEDBACK_STATUSES, FEEDBACK_TYPES, flattenAnnotation, IDENTITY_FIELD_MAX_LENGTH, isClosedStatus, isStoreDuplicate, isStoreLimit, isStoreNotFound, isStorePersistence, isStoreValueTooLong, MAX_COMMENTS_PER_FEEDBACK, OPEN_FEEDBACK_STATUSES, StoreDuplicateError, StoreLimitError, StoreNotFoundError, StorePersistenceError, StoreValueTooLongError, toFeedbackUpdate, } from "./types.js";
+export { errorFromResponse, feedbackQueryToSearchParams, isCommentGone, isThreadFull, mergeRequestHeaders, networkErrorFromException, newClientId, withSearchParams, } from "./wire.js";

package/dist/concurrency.d.cts

@@ -0,0 +1,14 @@
+/**
+ * Run `task` over every item with at most `concurrency` calls in flight and
+ * settle each call on its own, like `Promise.allSettled` over a bounded pool.
+ *
+ * Each call runs inside its own promise, so a task that throws synchronously
+ * is settled as a rejection instead of stopping the pool, and one failure
+ * never skips the remaining items.
+ *
+ * @param items - Inputs, processed in order.
+ * @param concurrency - Maximum number of simultaneous `task` calls (at least 1).
+ * @param task - Operation to run for each item.
+ * @returns The settled result of every call, in the order of `items`.
+ */
+export declare function settleWithConcurrencyLimit<Item, Result>(items: readonly Item[], concurrency: number, task: (item: Item) => Promise<Result>): Promise<Array<PromiseSettledResult<Result>>>;

package/dist/concurrency.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Run `task` over every item with at most `concurrency` calls in flight and
+ * settle each call on its own, like `Promise.allSettled` over a bounded pool.
+ *
+ * Each call runs inside its own promise, so a task that throws synchronously
+ * is settled as a rejection instead of stopping the pool, and one failure
+ * never skips the remaining items.
+ *
+ * @param items - Inputs, processed in order.
+ * @param concurrency - Maximum number of simultaneous `task` calls (at least 1).
+ * @param task - Operation to run for each item.
+ * @returns The settled result of every call, in the order of `items`.
+ */
+export declare function settleWithConcurrencyLimit<Item, Result>(items: readonly Item[], concurrency: number, task: (item: Item) => Promise<Result>): Promise<Array<PromiseSettledResult<Result>>>;

package/dist/constants/schema.d.cts

@@ -0,0 +1,239 @@
+declare const _BEEZPING_MODELS: {
+    readonly BeezpingFeedback: {
+        readonly fields: {
+            readonly id: {
+                readonly type: "String";
+                readonly isId: true;
+                readonly default: "cuid()";
+            };
+            readonly projectName: {
+                readonly type: "String";
+            };
+            readonly type: {
+                readonly type: "String";
+            };
+            readonly message: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly status: {
+                readonly type: "String";
+                readonly default: "\"open\"";
+            };
+            readonly url: {
+                readonly type: "String";
+            };
+            readonly urlPattern: {
+                readonly type: "String";
+                readonly optional: true;
+            };
+            readonly screenshotUrl: {
+                readonly type: "String";
+                readonly optional: true;
+                readonly nativeType: "Text";
+            };
+            readonly screenshotRegion: {
+                readonly type: "Json";
+                readonly optional: true;
+            };
+            readonly diagnostics: {
+                readonly type: "Json";
+                readonly optional: true;
+            };
+            readonly viewport: {
+                readonly type: "String";
+            };
+            readonly userAgent: {
+                readonly type: "String";
+            };
+            readonly authorName: {
+                readonly type: "String";
+            };
+            readonly authorEmail: {
+                readonly type: "String";
+            };
+            readonly clientId: {
+                readonly type: "String";
+                readonly isUnique: true;
+            };
+            readonly resolvedAt: {
+                readonly type: "DateTime";
+                readonly optional: true;
+            };
+            readonly createdAt: {
+                readonly type: "DateTime";
+                readonly default: "now()";
+            };
+            readonly updatedAt: {
+                readonly type: "DateTime";
+                readonly isUpdatedAt: true;
+            };
+            readonly annotations: {
+                readonly type: "BeezpingAnnotation";
+                readonly relation: {
+                    readonly kind: "1-to-many";
+                    readonly model: "BeezpingAnnotation";
+                };
+            };
+            readonly comments: {
+                readonly type: "BeezpingComment";
+                readonly relation: {
+                    readonly kind: "1-to-many";
+                    readonly model: "BeezpingComment";
+                };
+            };
+        };
+        readonly indexes: readonly [{
+            readonly fields: readonly ["projectName"];
+        }, {
+            readonly fields: readonly ["projectName", "status", "createdAt"];
+        }, {
+            readonly fields: readonly ["projectName", "url"];
+        }];
+    };
+    readonly BeezpingAnnotation: {
+        readonly fields: {
+            readonly id: {
+                readonly type: "String";
+                readonly isId: true;
+                readonly default: "cuid()";
+            };
+            readonly feedbackId: {
+                readonly type: "String";
+            };
+            readonly feedback: {
+                readonly type: "BeezpingFeedback";
+                readonly relation: {
+                    readonly kind: "many-to-1";
+                    readonly model: "BeezpingFeedback";
+                    readonly fields: readonly ["feedbackId"];
+                    readonly references: readonly ["id"];
+                    readonly onDelete: "Cascade";
+                };
+            };
+            readonly cssSelector: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly xpath: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly textSnippet: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly elementTag: {
+                readonly type: "String";
+            };
+            readonly elementId: {
+                readonly type: "String";
+                readonly optional: true;
+            };
+            readonly textPrefix: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly textSuffix: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly fingerprint: {
+                readonly type: "String";
+            };
+            readonly neighborText: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly anchorKey: {
+                readonly type: "String";
+                readonly optional: true;
+            };
+            readonly xPct: {
+                readonly type: "Float";
+            };
+            readonly yPct: {
+                readonly type: "Float";
+            };
+            readonly wPct: {
+                readonly type: "Float";
+            };
+            readonly hPct: {
+                readonly type: "Float";
+            };
+            readonly scrollX: {
+                readonly type: "Float";
+            };
+            readonly scrollY: {
+                readonly type: "Float";
+            };
+            readonly viewportW: {
+                readonly type: "Int";
+            };
+            readonly viewportH: {
+                readonly type: "Int";
+            };
+            readonly devicePixelRatio: {
+                readonly type: "Float";
+                readonly default: "1";
+            };
+            readonly createdAt: {
+                readonly type: "DateTime";
+                readonly default: "now()";
+            };
+        };
+        readonly indexes: readonly [{
+            readonly fields: readonly ["feedbackId"];
+        }];
+    };
+    readonly BeezpingComment: {
+        readonly fields: {
+            readonly id: {
+                readonly type: "String";
+                readonly isId: true;
+                readonly default: "cuid()";
+            };
+            readonly feedbackId: {
+                readonly type: "String";
+            };
+            readonly feedback: {
+                readonly type: "BeezpingFeedback";
+                readonly relation: {
+                    readonly kind: "many-to-1";
+                    readonly model: "BeezpingFeedback";
+                    readonly fields: readonly ["feedbackId"];
+                    readonly references: readonly ["id"];
+                    readonly onDelete: "Cascade";
+                };
+            };
+            readonly body: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly authorName: {
+                readonly type: "String";
+            };
+            readonly authorEmail: {
+                readonly type: "String";
+            };
+            readonly authorRole: {
+                readonly type: "String";
+                readonly default: "\"client\"";
+            };
+            readonly clientId: {
+                readonly type: "String";
+                readonly isUnique: true;
+            };
+            readonly createdAt: {
+                readonly type: "DateTime";
+                readonly default: "now()";
+            };
+        };
+        readonly indexes: readonly [{
+            readonly fields: readonly ["feedbackId", "createdAt"];
+        }];
+    };
+};
+/** Map of Beezping models keyed by model name — frozen at runtime. */
+export declare const BEEZPING_MODELS: typeof _BEEZPING_MODELS;
+export {};

package/dist/constants/schema.d.ts

@@ -0,0 +1,239 @@
+declare const _BEEZPING_MODELS: {
+    readonly BeezpingFeedback: {
+        readonly fields: {
+            readonly id: {
+                readonly type: "String";
+                readonly isId: true;
+                readonly default: "cuid()";
+            };
+            readonly projectName: {
+                readonly type: "String";
+            };
+            readonly type: {
+                readonly type: "String";
+            };
+            readonly message: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly status: {
+                readonly type: "String";
+                readonly default: "\"open\"";
+            };
+            readonly url: {
+                readonly type: "String";
+            };
+            readonly urlPattern: {
+                readonly type: "String";
+                readonly optional: true;
+            };
+            readonly screenshotUrl: {
+                readonly type: "String";
+                readonly optional: true;
+                readonly nativeType: "Text";
+            };
+            readonly screenshotRegion: {
+                readonly type: "Json";
+                readonly optional: true;
+            };
+            readonly diagnostics: {
+                readonly type: "Json";
+                readonly optional: true;
+            };
+            readonly viewport: {
+                readonly type: "String";
+            };
+            readonly userAgent: {
+                readonly type: "String";
+            };
+            readonly authorName: {
+                readonly type: "String";
+            };
+            readonly authorEmail: {
+                readonly type: "String";
+            };
+            readonly clientId: {
+                readonly type: "String";
+                readonly isUnique: true;
+            };
+            readonly resolvedAt: {
+                readonly type: "DateTime";
+                readonly optional: true;
+            };
+            readonly createdAt: {
+                readonly type: "DateTime";
+                readonly default: "now()";
+            };
+            readonly updatedAt: {
+                readonly type: "DateTime";
+                readonly isUpdatedAt: true;
+            };
+            readonly annotations: {
+                readonly type: "BeezpingAnnotation";
+                readonly relation: {
+                    readonly kind: "1-to-many";
+                    readonly model: "BeezpingAnnotation";
+                };
+            };
+            readonly comments: {
+                readonly type: "BeezpingComment";
+                readonly relation: {
+                    readonly kind: "1-to-many";
+                    readonly model: "BeezpingComment";
+                };
+            };
+        };
+        readonly indexes: readonly [{
+            readonly fields: readonly ["projectName"];
+        }, {
+            readonly fields: readonly ["projectName", "status", "createdAt"];
+        }, {
+            readonly fields: readonly ["projectName", "url"];
+        }];
+    };
+    readonly BeezpingAnnotation: {
+        readonly fields: {
+            readonly id: {
+                readonly type: "String";
+                readonly isId: true;
+                readonly default: "cuid()";
+            };
+            readonly feedbackId: {
+                readonly type: "String";
+            };
+            readonly feedback: {
+                readonly type: "BeezpingFeedback";
+                readonly relation: {
+                    readonly kind: "many-to-1";
+                    readonly model: "BeezpingFeedback";
+                    readonly fields: readonly ["feedbackId"];
+                    readonly references: readonly ["id"];
+                    readonly onDelete: "Cascade";
+                };
+            };
+            readonly cssSelector: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly xpath: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly textSnippet: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly elementTag: {
+                readonly type: "String";
+            };
+            readonly elementId: {
+                readonly type: "String";
+                readonly optional: true;
+            };
+            readonly textPrefix: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly textSuffix: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly fingerprint: {
+                readonly type: "String";
+            };
+            readonly neighborText: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly anchorKey: {
+                readonly type: "String";
+                readonly optional: true;
+            };
+            readonly xPct: {
+                readonly type: "Float";
+            };
+            readonly yPct: {
+                readonly type: "Float";
+            };
+            readonly wPct: {
+                readonly type: "Float";
+            };
+            readonly hPct: {
+                readonly type: "Float";
+            };
+            readonly scrollX: {
+                readonly type: "Float";
+            };
+            readonly scrollY: {
+                readonly type: "Float";
+            };
+            readonly viewportW: {
+                readonly type: "Int";
+            };
+            readonly viewportH: {
+                readonly type: "Int";
+            };
+            readonly devicePixelRatio: {
+                readonly type: "Float";
+                readonly default: "1";
+            };
+            readonly createdAt: {
+                readonly type: "DateTime";
+                readonly default: "now()";
+            };
+        };
+        readonly indexes: readonly [{
+            readonly fields: readonly ["feedbackId"];
+        }];
+    };
+    readonly BeezpingComment: {
+        readonly fields: {
+            readonly id: {
+                readonly type: "String";
+                readonly isId: true;
+                readonly default: "cuid()";
+            };
+            readonly feedbackId: {
+                readonly type: "String";
+            };
+            readonly feedback: {
+                readonly type: "BeezpingFeedback";
+                readonly relation: {
+                    readonly kind: "many-to-1";
+                    readonly model: "BeezpingFeedback";
+                    readonly fields: readonly ["feedbackId"];
+                    readonly references: readonly ["id"];
+                    readonly onDelete: "Cascade";
+                };
+            };
+            readonly body: {
+                readonly type: "String";
+                readonly nativeType: "Text";
+            };
+            readonly authorName: {
+                readonly type: "String";
+            };
+            readonly authorEmail: {
+                readonly type: "String";
+            };
+            readonly authorRole: {
+                readonly type: "String";
+                readonly default: "\"client\"";
+            };
+            readonly clientId: {
+                readonly type: "String";
+                readonly isUnique: true;
+            };
+            readonly createdAt: {
+                readonly type: "DateTime";
+                readonly default: "now()";
+            };
+        };
+        readonly indexes: readonly [{
+            readonly fields: readonly ["feedbackId", "createdAt"];
+        }];
+    };
+};
+/** Map of Beezping models keyed by model name — frozen at runtime. */
+export declare const BEEZPING_MODELS: typeof _BEEZPING_MODELS;
+export {};

package/dist/deep-link.d.cts

@@ -0,0 +1,14 @@
+import type { FeedbackRecord } from "./types.cjs";
+/**
+ * `url` resolved against `base`, when the result is an http(s) URL. A
+ * record's `url` is client-supplied: without the scheme allowlist, a crafted
+ * feedback (`javascript:…`, `data:…`) would turn into a live link.
+ */
+export declare function parseHttpUrl(url: string, base?: string): URL | null;
+/**
+ * Link that opens a feedback's page with the widget focused on it —
+ * `?<param>=<id>`, read by the widget's `deepLink` option. Relative record
+ * URLs (the widget stores `location.pathname` by default) resolve against
+ * `base`. Null when there is no safe http(s) target.
+ */
+export declare function buildDeepLink(record: Pick<FeedbackRecord, "id" | "url">, param: string, base?: string): string | null;

package/dist/deep-link.d.ts

@@ -0,0 +1,14 @@
+import type { FeedbackRecord } from "./types.js";
+/**
+ * `url` resolved against `base`, when the result is an http(s) URL. A
+ * record's `url` is client-supplied: without the scheme allowlist, a crafted
+ * feedback (`javascript:…`, `data:…`) would turn into a live link.
+ */
+export declare function parseHttpUrl(url: string, base?: string): URL | null;
+/**
+ * Link that opens a feedback's page with the widget focused on it —
+ * `?<param>=<id>`, read by the widget's `deepLink` option. Relative record
+ * URLs (the widget stores `location.pathname` by default) resolve against
+ * `base`. Null when there is no safe http(s) target.
+ */
+export declare function buildDeepLink(record: Pick<FeedbackRecord, "id" | "url">, param: string, base?: string): string | null;