context-drop 0.0.0-stage → 0.2.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 +709 -2
  3. package/app/assets/javascripts/context_drop/context_drop.js +8936 -0
  4. package/dist/app/javascript/context_drop/api-client.d.ts +41 -0
  5. package/dist/app/javascript/context_drop/api-client.js +279 -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 +32 -0
  9. package/dist/app/javascript/context_drop/icons.js +32 -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 +2015 -0
  20. package/dist/app/javascript/context_drop/types.d.ts +239 -0
  21. package/dist/app/javascript/context_drop/types.js +1 -0
  22. package/dist/app/javascript/context_drop/widget.d.ts +188 -0
  23. package/dist/app/javascript/context_drop/widget.js +3227 -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 +869 -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 +90 -0
  41. package/dist/src/react/index.js +124 -0
  42. package/dist/src/server/handler.d.ts +42 -0
  43. package/dist/src/server/handler.js +677 -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 +574 -0
  50. package/dist/src/server/storage/memory.d.ts +5 -0
  51. package/dist/src/server/storage/memory.js +221 -0
  52. package/dist/src/server/storage/postgres.d.ts +27 -0
  53. package/dist/src/server/storage/postgres.js +446 -0
  54. package/dist/src/server/types.d.ts +190 -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,124 @@
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, onError, onOpenChange } = props;
7
+ const [mounted, setMounted] = React.useState(false);
8
+ const elementRef = React.useRef(null);
9
+ const onSubmittedRef = React.useRef(onSubmitted);
10
+ const onErrorRef = React.useRef(onError);
11
+ const onOpenChangeRef = React.useRef(onOpenChange);
12
+ onSubmittedRef.current = onSubmitted;
13
+ onErrorRef.current = onError;
14
+ onOpenChangeRef.current = onOpenChange;
15
+ React.useEffect(() => {
16
+ registerContextDropWidget();
17
+ setMounted(true);
18
+ }, []);
19
+ React.useImperativeHandle(forwardedRef, () => ({
20
+ open: () => elementRef.current?.openComposer(),
21
+ close: () => elementRef.current?.closeComposer(),
22
+ toggle: () => elementRef.current?.toggleComposer(),
23
+ get element() {
24
+ return elementRef.current;
25
+ }
26
+ }), []);
27
+ const serializedMetadata = React.useMemo(() => (metadata ? JSON.stringify(metadata) : undefined), [metadata]);
28
+ const serializedConfig = React.useMemo(() => (config ? JSON.stringify(config) : undefined), [config]);
29
+ React.useEffect(() => {
30
+ const el = elementRef.current;
31
+ if (!el)
32
+ return;
33
+ if (headers) {
34
+ el.setHeaders(headers);
35
+ }
36
+ else {
37
+ el.setHeaders({});
38
+ }
39
+ }, [mounted, headers]);
40
+ React.useEffect(() => {
41
+ const el = elementRef.current;
42
+ if (!el)
43
+ return;
44
+ const handleSubmit = (ev) => {
45
+ const detail = ev.detail;
46
+ if (detail && onSubmittedRef.current) {
47
+ onSubmittedRef.current(detail);
48
+ }
49
+ };
50
+ const handleError = (ev) => {
51
+ const detail = ev.detail;
52
+ if (detail && onErrorRef.current) {
53
+ onErrorRef.current(detail);
54
+ }
55
+ };
56
+ const handleOpen = () => {
57
+ onOpenChangeRef.current?.(true);
58
+ };
59
+ const handleClose = () => {
60
+ onOpenChangeRef.current?.(false);
61
+ };
62
+ el.addEventListener("context-drop:submit", handleSubmit);
63
+ el.addEventListener("context-drop:error", handleError);
64
+ el.addEventListener("context-drop:open", handleOpen);
65
+ el.addEventListener("context-drop:close", handleClose);
66
+ return () => {
67
+ el.removeEventListener("context-drop:submit", handleSubmit);
68
+ el.removeEventListener("context-drop:error", handleError);
69
+ el.removeEventListener("context-drop:open", handleOpen);
70
+ el.removeEventListener("context-drop:close", handleClose);
71
+ };
72
+ }, [mounted, disabled]);
73
+ if (!mounted || disabled) {
74
+ return null;
75
+ }
76
+ const elementAttributes = {
77
+ ref: elementRef,
78
+ "data-endpoint": endpoint
79
+ };
80
+ if (position)
81
+ elementAttributes["data-position"] = position.replace("-", "_");
82
+ if (placeholder)
83
+ elementAttributes["data-placeholder"] = placeholder;
84
+ if (theme)
85
+ elementAttributes["data-cd-theme"] = theme;
86
+ if (selectionMode)
87
+ elementAttributes["data-selection-mode"] = selectionMode;
88
+ if (environment)
89
+ elementAttributes["data-environment"] = environment;
90
+ if (credentials)
91
+ elementAttributes["data-credentials"] = credentials;
92
+ if (serializedMetadata)
93
+ elementAttributes["data-metadata"] = serializedMetadata;
94
+ if (serializedConfig)
95
+ elementAttributes["data-config"] = serializedConfig;
96
+ return React.createElement("context-drop-widget", elementAttributes);
97
+ });
98
+ export const ContextDropWidget = ContextDrop;
99
+ /**
100
+ * Imperative helper hook to open, close, or toggle the mounted `<ContextDrop />` widget
101
+ * from any button or menu item in your React/Next.js tree without requiring a Context Provider.
102
+ */
103
+ export function useContextDrop() {
104
+ const getElement = React.useCallback(() => {
105
+ if (typeof document === "undefined")
106
+ return null;
107
+ return document.querySelector("context-drop-widget");
108
+ }, []);
109
+ const open = React.useCallback(() => {
110
+ getElement()?.openComposer();
111
+ }, [getElement]);
112
+ const close = React.useCallback(() => {
113
+ getElement()?.closeComposer();
114
+ }, [getElement]);
115
+ const toggle = React.useCallback(() => {
116
+ getElement()?.toggleComposer();
117
+ }, [getElement]);
118
+ return {
119
+ open,
120
+ close,
121
+ toggle,
122
+ getElement
123
+ };
124
+ }
@@ -0,0 +1,42 @@
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 defineContextDropConfig(config: ContextDropServerConfig): ContextDropServerConfig;
4
+ export interface ContextDropFetchHandler {
5
+ (request: Request): Promise<Response>;
6
+ resetRateLimits: () => void;
7
+ getStorage: () => StorageAdapter;
8
+ }
9
+ export declare function createContextDropFetchHandler(config?: ContextDropServerConfig): ContextDropFetchHandler;
10
+ /**
11
+ * Next.js App Router route handler factory (`app/api/context-drop/[[...path]]/route.ts`).
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * import { createContextDropNextHandler } from "context-drop/next/server";
16
+ * export const { GET, POST, OPTIONS } = createContextDropNextHandler();
17
+ * ```
18
+ */
19
+ export declare function createContextDropNextHandler(config?: ContextDropServerConfig): {
20
+ GET: (request: Request) => Promise<Response>;
21
+ POST: (request: Request) => Promise<Response>;
22
+ OPTIONS: (request: Request) => Promise<Response>;
23
+ handler: ContextDropFetchHandler;
24
+ };
25
+ export interface PagesApiRequestLike extends AsyncIterable<Uint8Array | string> {
26
+ method?: string;
27
+ url?: string;
28
+ headers: Record<string, string | string[] | undefined>;
29
+ body?: unknown;
30
+ }
31
+ export interface PagesApiResponseLike {
32
+ statusCode: number;
33
+ setHeader(name: string, value: string): unknown;
34
+ end(chunk?: Uint8Array | string): unknown;
35
+ }
36
+ /**
37
+ * Next.js Pages Router / Node HTTP handler factory (`pages/api/context-drop/[[...path]].ts`).
38
+ *
39
+ * Works both with `export const config = { api: { bodyParser: false } }` (required for
40
+ * multipart `/attachments` uploads) and with pre-parsed JSON bodies.
41
+ */
42
+ export declare function createContextDropPagesHandler(config?: ContextDropServerConfig): (req: PagesApiRequestLike, res: PagesApiResponseLike) => Promise<void>;