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.
- package/MIT-LICENSE +21 -0
- package/README.md +709 -2
- package/app/assets/javascripts/context_drop/context_drop.js +8936 -0
- package/dist/app/javascript/context_drop/api-client.d.ts +41 -0
- package/dist/app/javascript/context_drop/api-client.js +279 -0
- package/dist/app/javascript/context_drop/element-picker.d.ts +111 -0
- package/dist/app/javascript/context_drop/element-picker.js +1428 -0
- package/dist/app/javascript/context_drop/icons.d.ts +32 -0
- package/dist/app/javascript/context_drop/icons.js +32 -0
- package/dist/app/javascript/context_drop/index.d.ts +7 -0
- package/dist/app/javascript/context_drop/index.js +9 -0
- package/dist/app/javascript/context_drop/markdown.d.ts +7 -0
- package/dist/app/javascript/context_drop/markdown.js +129 -0
- package/dist/app/javascript/context_drop/sanitizer.d.ts +38 -0
- package/dist/app/javascript/context_drop/sanitizer.js +769 -0
- package/dist/app/javascript/context_drop/screenshot.d.ts +21 -0
- package/dist/app/javascript/context_drop/screenshot.js +245 -0
- package/dist/app/javascript/context_drop/styles.d.ts +1 -0
- package/dist/app/javascript/context_drop/styles.js +2015 -0
- package/dist/app/javascript/context_drop/types.d.ts +239 -0
- package/dist/app/javascript/context_drop/types.js +1 -0
- package/dist/app/javascript/context_drop/widget.d.ts +188 -0
- package/dist/app/javascript/context_drop/widget.js +3227 -0
- package/dist/src/cli.d.ts +3 -0
- package/dist/src/cli.js +207 -0
- package/dist/src/index.d.ts +5 -0
- package/dist/src/index.js +5 -0
- package/dist/src/mcp/dispatcher.d.ts +42 -0
- package/dist/src/mcp/dispatcher.js +869 -0
- package/dist/src/mcp/environment-router.d.ts +38 -0
- package/dist/src/mcp/environment-router.js +174 -0
- package/dist/src/mcp/index.d.ts +24 -0
- package/dist/src/mcp/index.js +75 -0
- package/dist/src/mcp/remote-client.d.ts +25 -0
- package/dist/src/mcp/remote-client.js +98 -0
- package/dist/src/next/index.d.ts +13 -0
- package/dist/src/next/index.js +25 -0
- package/dist/src/next/server.d.ts +1 -0
- package/dist/src/next/server.js +1 -0
- package/dist/src/react/index.d.ts +90 -0
- package/dist/src/react/index.js +124 -0
- package/dist/src/server/handler.d.ts +42 -0
- package/dist/src/server/handler.js +677 -0
- package/dist/src/server/index.d.ts +8 -0
- package/dist/src/server/index.js +8 -0
- package/dist/src/server/sanitizer.d.ts +15 -0
- package/dist/src/server/sanitizer.js +201 -0
- package/dist/src/server/storage/local.d.ts +22 -0
- package/dist/src/server/storage/local.js +574 -0
- package/dist/src/server/storage/memory.d.ts +5 -0
- package/dist/src/server/storage/memory.js +221 -0
- package/dist/src/server/storage/postgres.d.ts +27 -0
- package/dist/src/server/storage/postgres.js +446 -0
- package/dist/src/server/types.d.ts +190 -0
- package/dist/src/server/types.js +7 -0
- package/dist/src/server/upload-validator.d.ts +16 -0
- package/dist/src/server/upload-validator.js +196 -0
- package/dist/src/widget/index.d.ts +1 -0
- package/dist/src/widget/index.js +1 -0
- 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>;
|