context-drop 0.0.0-stage → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/MIT-LICENSE +21 -0
  2. package/README.md +710 -2
  3. package/app/assets/javascripts/context_drop/context_drop.js +9949 -0
  4. package/dist/app/javascript/context_drop/api-client.d.ts +53 -0
  5. package/dist/app/javascript/context_drop/api-client.js +470 -0
  6. package/dist/app/javascript/context_drop/element-picker.d.ts +111 -0
  7. package/dist/app/javascript/context_drop/element-picker.js +1428 -0
  8. package/dist/app/javascript/context_drop/icons.d.ts +34 -0
  9. package/dist/app/javascript/context_drop/icons.js +34 -0
  10. package/dist/app/javascript/context_drop/index.d.ts +7 -0
  11. package/dist/app/javascript/context_drop/index.js +9 -0
  12. package/dist/app/javascript/context_drop/markdown.d.ts +7 -0
  13. package/dist/app/javascript/context_drop/markdown.js +129 -0
  14. package/dist/app/javascript/context_drop/sanitizer.d.ts +38 -0
  15. package/dist/app/javascript/context_drop/sanitizer.js +769 -0
  16. package/dist/app/javascript/context_drop/screenshot.d.ts +21 -0
  17. package/dist/app/javascript/context_drop/screenshot.js +245 -0
  18. package/dist/app/javascript/context_drop/styles.d.ts +1 -0
  19. package/dist/app/javascript/context_drop/styles.js +2196 -0
  20. package/dist/app/javascript/context_drop/types.d.ts +316 -0
  21. package/dist/app/javascript/context_drop/types.js +1 -0
  22. package/dist/app/javascript/context_drop/widget.d.ts +206 -0
  23. package/dist/app/javascript/context_drop/widget.js +3752 -0
  24. package/dist/src/cli.d.ts +3 -0
  25. package/dist/src/cli.js +207 -0
  26. package/dist/src/index.d.ts +5 -0
  27. package/dist/src/index.js +5 -0
  28. package/dist/src/mcp/dispatcher.d.ts +42 -0
  29. package/dist/src/mcp/dispatcher.js +895 -0
  30. package/dist/src/mcp/environment-router.d.ts +38 -0
  31. package/dist/src/mcp/environment-router.js +174 -0
  32. package/dist/src/mcp/index.d.ts +24 -0
  33. package/dist/src/mcp/index.js +75 -0
  34. package/dist/src/mcp/remote-client.d.ts +25 -0
  35. package/dist/src/mcp/remote-client.js +98 -0
  36. package/dist/src/next/index.d.ts +13 -0
  37. package/dist/src/next/index.js +25 -0
  38. package/dist/src/next/server.d.ts +1 -0
  39. package/dist/src/next/server.js +1 -0
  40. package/dist/src/react/index.d.ts +104 -0
  41. package/dist/src/react/index.js +144 -0
  42. package/dist/src/server/handler.d.ts +48 -0
  43. package/dist/src/server/handler.js +1180 -0
  44. package/dist/src/server/index.d.ts +8 -0
  45. package/dist/src/server/index.js +8 -0
  46. package/dist/src/server/sanitizer.d.ts +15 -0
  47. package/dist/src/server/sanitizer.js +201 -0
  48. package/dist/src/server/storage/local.d.ts +22 -0
  49. package/dist/src/server/storage/local.js +827 -0
  50. package/dist/src/server/storage/memory.d.ts +8 -0
  51. package/dist/src/server/storage/memory.js +387 -0
  52. package/dist/src/server/storage/postgres.d.ts +27 -0
  53. package/dist/src/server/storage/postgres.js +629 -0
  54. package/dist/src/server/types.d.ts +227 -0
  55. package/dist/src/server/types.js +7 -0
  56. package/dist/src/server/upload-validator.d.ts +16 -0
  57. package/dist/src/server/upload-validator.js +196 -0
  58. package/dist/src/widget/index.d.ts +1 -0
  59. package/dist/src/widget/index.js +1 -0
  60. package/package.json +99 -4
@@ -0,0 +1,144 @@
1
+ "use client";
2
+ import * as React from "react";
3
+ import { ContextDropWidgetElement, registerContextDropWidget } from "../../app/javascript/context_drop/widget.js";
4
+ export { ContextDropWidgetElement, registerContextDropWidget };
5
+ export const ContextDrop = React.forwardRef(function ContextDrop(props, forwardedRef) {
6
+ const { endpoint = "/context_drop", position, placeholder, theme, selectionMode, environment, metadata, config, credentials, headers, disabled = false, onSubmitted, onUpdated, onDeleted, onError, onOpenChange } = props;
7
+ const [mounted, setMounted] = React.useState(false);
8
+ const elementRef = React.useRef(null);
9
+ const onSubmittedRef = React.useRef(onSubmitted);
10
+ const onUpdatedRef = React.useRef(onUpdated);
11
+ const onDeletedRef = React.useRef(onDeleted);
12
+ const onErrorRef = React.useRef(onError);
13
+ const onOpenChangeRef = React.useRef(onOpenChange);
14
+ onSubmittedRef.current = onSubmitted;
15
+ onUpdatedRef.current = onUpdated;
16
+ onDeletedRef.current = onDeleted;
17
+ onErrorRef.current = onError;
18
+ onOpenChangeRef.current = onOpenChange;
19
+ React.useEffect(() => {
20
+ registerContextDropWidget();
21
+ setMounted(true);
22
+ }, []);
23
+ React.useImperativeHandle(forwardedRef, () => ({
24
+ open: () => elementRef.current?.openComposer(),
25
+ close: () => elementRef.current?.closeComposer(),
26
+ toggle: () => elementRef.current?.toggleComposer(),
27
+ get element() {
28
+ return elementRef.current;
29
+ }
30
+ }), []);
31
+ const serializedMetadata = React.useMemo(() => (metadata ? JSON.stringify(metadata) : undefined), [metadata]);
32
+ const serializedConfig = React.useMemo(() => (config ? JSON.stringify(config) : undefined), [config]);
33
+ React.useEffect(() => {
34
+ const el = elementRef.current;
35
+ if (!el)
36
+ return;
37
+ if (headers) {
38
+ el.setHeaders(headers);
39
+ }
40
+ else {
41
+ el.setHeaders({});
42
+ }
43
+ }, [mounted, headers]);
44
+ React.useEffect(() => {
45
+ const el = elementRef.current;
46
+ if (!el)
47
+ return;
48
+ const handleSubmit = (ev) => {
49
+ const detail = ev.detail;
50
+ if (detail && onSubmittedRef.current) {
51
+ onSubmittedRef.current(detail);
52
+ }
53
+ };
54
+ const handleUpdate = (ev) => {
55
+ const detail = ev.detail;
56
+ if (detail && onUpdatedRef.current) {
57
+ onUpdatedRef.current(detail);
58
+ }
59
+ };
60
+ const handleDelete = (ev) => {
61
+ const detail = ev.detail;
62
+ if (detail && onDeletedRef.current) {
63
+ onDeletedRef.current(detail);
64
+ }
65
+ };
66
+ const handleError = (ev) => {
67
+ const detail = ev.detail;
68
+ if (detail && onErrorRef.current) {
69
+ onErrorRef.current(detail);
70
+ }
71
+ };
72
+ const handleOpen = () => {
73
+ onOpenChangeRef.current?.(true);
74
+ };
75
+ const handleClose = () => {
76
+ onOpenChangeRef.current?.(false);
77
+ };
78
+ el.addEventListener("context-drop:submit", handleSubmit);
79
+ el.addEventListener("context-drop:update", handleUpdate);
80
+ el.addEventListener("context-drop:delete", handleDelete);
81
+ el.addEventListener("context-drop:error", handleError);
82
+ el.addEventListener("context-drop:open", handleOpen);
83
+ el.addEventListener("context-drop:close", handleClose);
84
+ return () => {
85
+ el.removeEventListener("context-drop:submit", handleSubmit);
86
+ el.removeEventListener("context-drop:update", handleUpdate);
87
+ el.removeEventListener("context-drop:delete", handleDelete);
88
+ el.removeEventListener("context-drop:error", handleError);
89
+ el.removeEventListener("context-drop:open", handleOpen);
90
+ el.removeEventListener("context-drop:close", handleClose);
91
+ };
92
+ }, [mounted, disabled]);
93
+ if (!mounted || disabled) {
94
+ return null;
95
+ }
96
+ const elementAttributes = {
97
+ ref: elementRef,
98
+ "data-endpoint": endpoint
99
+ };
100
+ if (position)
101
+ elementAttributes["data-position"] = position.replace("-", "_");
102
+ if (placeholder)
103
+ elementAttributes["data-placeholder"] = placeholder;
104
+ if (theme)
105
+ elementAttributes["data-cd-theme"] = theme;
106
+ if (selectionMode)
107
+ elementAttributes["data-selection-mode"] = selectionMode;
108
+ if (environment)
109
+ elementAttributes["data-environment"] = environment;
110
+ if (credentials)
111
+ elementAttributes["data-credentials"] = credentials;
112
+ if (serializedMetadata)
113
+ elementAttributes["data-metadata"] = serializedMetadata;
114
+ if (serializedConfig)
115
+ elementAttributes["data-config"] = serializedConfig;
116
+ return React.createElement("context-drop-widget", elementAttributes);
117
+ });
118
+ export const ContextDropWidget = ContextDrop;
119
+ /**
120
+ * Imperative helper hook to open, close, or toggle the mounted `<ContextDrop />` widget
121
+ * from any button or menu item in your React/Next.js tree without requiring a Context Provider.
122
+ */
123
+ export function useContextDrop() {
124
+ const getElement = React.useCallback(() => {
125
+ if (typeof document === "undefined")
126
+ return null;
127
+ return document.querySelector("context-drop-widget");
128
+ }, []);
129
+ const open = React.useCallback(() => {
130
+ getElement()?.openComposer();
131
+ }, [getElement]);
132
+ const close = React.useCallback(() => {
133
+ getElement()?.closeComposer();
134
+ }, [getElement]);
135
+ const toggle = React.useCallback(() => {
136
+ getElement()?.toggleComposer();
137
+ }, [getElement]);
138
+ return {
139
+ open,
140
+ close,
141
+ toggle,
142
+ getElement
143
+ };
144
+ }
@@ -0,0 +1,48 @@
1
+ import { type ContextDropServerConfig, type StorageAdapter } from "./types.js";
2
+ export declare function isOriginExplicitlyAllowed(originHeader: string | null | undefined, allowedOrigins?: Array<string | RegExp>): boolean;
3
+ export declare function generateOwnershipToken(feedbackId: string | number, secret: Buffer): string;
4
+ export declare function verifyOwnershipToken(token: string | null | undefined, feedbackId: string | number, secret: Buffer): boolean;
5
+ export declare function extractVerifiedOwnershipIds(rawTokens: string, secret: Buffer): string[];
6
+ export declare function defineContextDropConfig(config: ContextDropServerConfig): ContextDropServerConfig;
7
+ export interface ContextDropFetchHandler {
8
+ (request: Request): Promise<Response>;
9
+ resetRateLimits: () => void;
10
+ getStorage: () => StorageAdapter;
11
+ }
12
+ export declare function createContextDropFetchHandler(config?: ContextDropServerConfig): ContextDropFetchHandler;
13
+ /**
14
+ * Next.js App Router route handler factory (`app/api/context-drop/[[...path]]/route.ts`).
15
+ *
16
+ * @example
17
+ * ```ts
18
+ * import { createContextDropNextHandler } from "context-drop/next/server";
19
+ * export const { GET, POST, PATCH, PUT, DELETE, OPTIONS } = createContextDropNextHandler();
20
+ * ```
21
+ */
22
+ export declare function createContextDropNextHandler(config?: ContextDropServerConfig): {
23
+ GET: (request: Request) => Promise<Response>;
24
+ POST: (request: Request) => Promise<Response>;
25
+ PATCH: (request: Request) => Promise<Response>;
26
+ PUT: (request: Request) => Promise<Response>;
27
+ DELETE: (request: Request) => Promise<Response>;
28
+ OPTIONS: (request: Request) => Promise<Response>;
29
+ handler: ContextDropFetchHandler;
30
+ };
31
+ export interface PagesApiRequestLike extends AsyncIterable<Uint8Array | string> {
32
+ method?: string;
33
+ url?: string;
34
+ headers: Record<string, string | string[] | undefined>;
35
+ body?: unknown;
36
+ }
37
+ export interface PagesApiResponseLike {
38
+ statusCode: number;
39
+ setHeader(name: string, value: string): unknown;
40
+ end(chunk?: Uint8Array | string): unknown;
41
+ }
42
+ /**
43
+ * Next.js Pages Router / Node HTTP handler factory (`pages/api/context-drop/[[...path]].ts`).
44
+ *
45
+ * Works both with `export const config = { api: { bodyParser: false } }` (required for
46
+ * multipart `/attachments` uploads) and with pre-parsed JSON bodies.
47
+ */
48
+ export declare function createContextDropPagesHandler(config?: ContextDropServerConfig): (req: PagesApiRequestLike, res: PagesApiResponseLike) => Promise<void>;