@fragno-dev/core 0.1.2 → 0.1.3

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 (53) hide show
  1. package/.turbo/turbo-build.log +40 -31
  2. package/CHANGELOG.md +9 -0
  3. package/LICENSE.md +16 -0
  4. package/dist/api/api.d.ts +1 -1
  5. package/dist/api/fragment-builder.d.ts +2 -2
  6. package/dist/api/fragment-instantiation.d.ts +2 -2
  7. package/dist/api/fragment-instantiation.js +3 -2
  8. package/dist/{api-jKNXmz2B.d.ts → api-BX90b4-D.d.ts} +2 -2
  9. package/dist/{api-jKNXmz2B.d.ts.map → api-BX90b4-D.d.ts.map} +1 -1
  10. package/dist/client/client.d.ts +2 -2
  11. package/dist/client/client.js +4 -3
  12. package/dist/client/client.svelte.d.ts +2 -2
  13. package/dist/client/client.svelte.js +4 -3
  14. package/dist/client/client.svelte.js.map +1 -1
  15. package/dist/client/react.d.ts +2 -2
  16. package/dist/client/react.js +4 -3
  17. package/dist/client/react.js.map +1 -1
  18. package/dist/client/solid.d.ts +2 -2
  19. package/dist/client/solid.js +4 -3
  20. package/dist/client/solid.js.map +1 -1
  21. package/dist/client/vanilla.d.ts +2 -2
  22. package/dist/client/vanilla.js +4 -3
  23. package/dist/client/vanilla.js.map +1 -1
  24. package/dist/client/vue.d.ts +2 -2
  25. package/dist/client/vue.js +4 -3
  26. package/dist/client/vue.js.map +1 -1
  27. package/dist/{client-CzWq6IlK.js → client-C6LChM0Y.js} +4 -3
  28. package/dist/{client-CzWq6IlK.js.map → client-C6LChM0Y.js.map} +1 -1
  29. package/dist/{fragment-builder-B3JXWiZB.d.ts → fragment-builder-BZr2JkuW.d.ts} +35 -35
  30. package/dist/fragment-builder-BZr2JkuW.d.ts.map +1 -0
  31. package/dist/fragment-builder-DOnCVBqc.js.map +1 -1
  32. package/dist/{fragment-instantiation-D1q7pltx.js → fragment-instantiation-DMw8OKMC.js} +3 -2
  33. package/dist/{fragment-instantiation-D1q7pltx.js.map → fragment-instantiation-DMw8OKMC.js.map} +1 -1
  34. package/dist/integrations/react-ssr.js +1 -1
  35. package/dist/mod.d.ts +2 -2
  36. package/dist/mod.js +3 -2
  37. package/dist/route-CTxjMtGZ.js +10 -0
  38. package/dist/route-CTxjMtGZ.js.map +1 -0
  39. package/dist/{route-DbBZ3Ep9.js → route-D1MZR6JL.js} +2 -10
  40. package/dist/route-D1MZR6JL.js.map +1 -0
  41. package/dist/{ssr-CamRrMc0.js → ssr-BByDVfFD.js} +1 -1
  42. package/dist/{ssr-CamRrMc0.js.map → ssr-BByDVfFD.js.map} +1 -1
  43. package/dist/test/test.d.ts +112 -0
  44. package/dist/test/test.d.ts.map +1 -0
  45. package/dist/test/test.js +155 -0
  46. package/dist/test/test.js.map +1 -0
  47. package/package.json +18 -24
  48. package/src/api/fragment-builder.ts +0 -1
  49. package/src/test/test.test.ts +449 -0
  50. package/src/test/test.ts +379 -0
  51. package/tsdown.config.ts +1 -0
  52. package/dist/fragment-builder-B3JXWiZB.d.ts.map +0 -1
  53. package/dist/route-DbBZ3Ep9.js.map +0 -1
@@ -0,0 +1,112 @@
1
+ import { f as ExtractPathParams, n as HTTPMethod, t as FragnoRouteConfig } from "../api-BX90b4-D.js";
2
+ import { B as AnyRouteOrFactory, V as FlattenRouteFactories, c as FragnoPublicConfig, n as FragmentDefinition } from "../fragment-builder-BZr2JkuW.js";
3
+ import { StandardSchemaV1 } from "@standard-schema/spec";
4
+
5
+ //#region src/test/test.d.ts
6
+
7
+ /**
8
+ * Discriminated union representing all possible test response types
9
+ */
10
+ type TestResponse<T> = {
11
+ type: "empty";
12
+ status: number;
13
+ headers: Headers;
14
+ } | {
15
+ type: "error";
16
+ status: number;
17
+ headers: Headers;
18
+ error: {
19
+ message: string;
20
+ code: string;
21
+ };
22
+ } | {
23
+ type: "json";
24
+ status: number;
25
+ headers: Headers;
26
+ data: T;
27
+ } | {
28
+ type: "jsonStream";
29
+ status: number;
30
+ headers: Headers;
31
+ stream: AsyncGenerator<T>;
32
+ };
33
+ /**
34
+ * Options for creating a test fragment
35
+ */
36
+ interface CreateFragmentForTestOptions<TConfig, TDeps, TServices, TAdditionalContext extends Record<string, unknown>, TOptions extends FragnoPublicConfig> {
37
+ config: TConfig;
38
+ options?: Partial<TOptions>;
39
+ deps?: Partial<TDeps>;
40
+ services?: Partial<TServices>;
41
+ additionalContext?: Partial<TAdditionalContext>;
42
+ }
43
+ /**
44
+ * Options for calling a route handler
45
+ */
46
+ interface RouteHandlerInputOptions<TPath extends string, TInputSchema extends StandardSchemaV1 | undefined> {
47
+ pathParams?: ExtractPathParams<TPath>;
48
+ body?: TInputSchema extends StandardSchemaV1 ? StandardSchemaV1.InferInput<TInputSchema> : never;
49
+ query?: URLSearchParams | Record<string, string>;
50
+ headers?: Headers | Record<string, string>;
51
+ }
52
+ /**
53
+ * Options for overriding config/deps/services when initializing routes
54
+ */
55
+ interface InitRoutesOverrides<TConfig, TDeps, TServices> {
56
+ config?: Partial<TConfig>;
57
+ deps?: Partial<TDeps>;
58
+ services?: Partial<TServices>;
59
+ }
60
+ /**
61
+ * Fragment test instance with type-safe handler method
62
+ */
63
+ interface FragmentForTest<TConfig, TDeps, TServices, TAdditionalContext extends Record<string, unknown>, TOptions extends FragnoPublicConfig> {
64
+ config: TConfig;
65
+ deps: TDeps;
66
+ services: TServices;
67
+ additionalContext: TAdditionalContext & TOptions;
68
+ handler: <TMethod extends HTTPMethod, TPath extends string, TInputSchema extends StandardSchemaV1 | undefined, TOutputSchema extends StandardSchemaV1 | undefined, TErrorCode extends string, TQueryParameters extends string>(route: FragnoRouteConfig<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters>, inputOptions?: RouteHandlerInputOptions<TPath, TInputSchema>) => Promise<TestResponse<TOutputSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TOutputSchema> : unknown>>;
69
+ initRoutes: <const TRoutesOrFactories extends readonly AnyRouteOrFactory[]>(routesOrFactories: TRoutesOrFactories, overrides?: InitRoutesOverrides<TConfig, TDeps, TServices>) => FlattenRouteFactories<TRoutesOrFactories>;
70
+ }
71
+ /**
72
+ * Create a fragment instance for testing with optional dependency and service overrides
73
+ *
74
+ * @param fragmentBuilder - The fragment builder with definition and required options
75
+ * @param options - Configuration and optional overrides for deps/services
76
+ * @returns A fragment test instance with a type-safe handler method
77
+ *
78
+ * @example
79
+ * ```typescript
80
+ * const fragment = createFragmentForTest(chatnoDefinition, {
81
+ * config: { openaiApiKey: "test-key" },
82
+ * options: { mountRoute: "/api/chatno" },
83
+ * services: {
84
+ * generateStreamMessages: mockGenerator
85
+ * }
86
+ * });
87
+ *
88
+ * // Initialize routes with fragment's config/deps/services
89
+ * const [route] = fragment.initRoutes(routes);
90
+ *
91
+ * // Or override specific config/deps/services for certain routes
92
+ * const [route] = fragment.initRoutes(routes, {
93
+ * services: { mockService: mockImplementation }
94
+ * });
95
+ *
96
+ * const response = await fragment.handler(route, {
97
+ * pathParams: { id: "123" },
98
+ * body: { message: "Hello" }
99
+ * });
100
+ *
101
+ * if (response.type === 'json') {
102
+ * expect(response.data).toEqual({...});
103
+ * }
104
+ * ```
105
+ */
106
+ declare function createFragmentForTest<TConfig, TDeps, TServices extends Record<string, unknown>, TAdditionalContext extends Record<string, unknown>, TOptions extends FragnoPublicConfig>(fragmentBuilder: {
107
+ definition: FragmentDefinition<TConfig, TDeps, TServices, TAdditionalContext>;
108
+ $requiredOptions: TOptions;
109
+ }, options: CreateFragmentForTestOptions<TConfig, TDeps, TServices, TAdditionalContext, TOptions>): FragmentForTest<TConfig, TDeps, TServices, TAdditionalContext, TOptions>;
110
+ //#endregion
111
+ export { CreateFragmentForTestOptions, FragmentForTest, InitRoutesOverrides, RouteHandlerInputOptions, TestResponse, createFragmentForTest };
112
+ //# sourceMappingURL=test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test.d.ts","names":[],"sources":["../../src/test/test.ts"],"sourcesContent":[],"mappings":"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"}
@@ -0,0 +1,155 @@
1
+ import "../api-DngJDcmO.js";
2
+ import { a as RequestOutputContext, o as RequestInputContext, r as resolveRouteFactories } from "../route-D1MZR6JL.js";
3
+
4
+ //#region src/test/test.ts
5
+ /**
6
+ * Parse a Response object into a TestResponse discriminated union
7
+ */
8
+ async function parseResponse(response) {
9
+ const status = response.status;
10
+ const headers = response.headers;
11
+ if ((headers.get("content-type") || "").includes("application/x-ndjson")) return {
12
+ type: "jsonStream",
13
+ status,
14
+ headers,
15
+ stream: parseNDJSONStream(response)
16
+ };
17
+ const text = await response.text();
18
+ if (!text || text === "null") return {
19
+ type: "empty",
20
+ status,
21
+ headers
22
+ };
23
+ const data = JSON.parse(text);
24
+ if (data && typeof data === "object" && "message" in data && "code" in data) return {
25
+ type: "error",
26
+ status,
27
+ headers,
28
+ error: {
29
+ message: data.message,
30
+ code: data.code
31
+ }
32
+ };
33
+ return {
34
+ type: "json",
35
+ status,
36
+ headers,
37
+ data
38
+ };
39
+ }
40
+ /**
41
+ * Parse an NDJSON stream into an async generator
42
+ */
43
+ async function* parseNDJSONStream(response) {
44
+ if (!response.body) return;
45
+ const reader = response.body.getReader();
46
+ const decoder = new TextDecoder();
47
+ let buffer = "";
48
+ try {
49
+ while (true) {
50
+ const { done, value } = await reader.read();
51
+ if (done) break;
52
+ buffer += decoder.decode(value, { stream: true });
53
+ const lines = buffer.split("\n");
54
+ buffer = lines.pop() || "";
55
+ for (const line of lines) if (line.trim()) yield JSON.parse(line);
56
+ }
57
+ if (buffer.trim()) yield JSON.parse(buffer);
58
+ } finally {
59
+ reader.releaseLock();
60
+ }
61
+ }
62
+ /**
63
+ * Create a fragment instance for testing with optional dependency and service overrides
64
+ *
65
+ * @param fragmentBuilder - The fragment builder with definition and required options
66
+ * @param options - Configuration and optional overrides for deps/services
67
+ * @returns A fragment test instance with a type-safe handler method
68
+ *
69
+ * @example
70
+ * ```typescript
71
+ * const fragment = createFragmentForTest(chatnoDefinition, {
72
+ * config: { openaiApiKey: "test-key" },
73
+ * options: { mountRoute: "/api/chatno" },
74
+ * services: {
75
+ * generateStreamMessages: mockGenerator
76
+ * }
77
+ * });
78
+ *
79
+ * // Initialize routes with fragment's config/deps/services
80
+ * const [route] = fragment.initRoutes(routes);
81
+ *
82
+ * // Or override specific config/deps/services for certain routes
83
+ * const [route] = fragment.initRoutes(routes, {
84
+ * services: { mockService: mockImplementation }
85
+ * });
86
+ *
87
+ * const response = await fragment.handler(route, {
88
+ * pathParams: { id: "123" },
89
+ * body: { message: "Hello" }
90
+ * });
91
+ *
92
+ * if (response.type === 'json') {
93
+ * expect(response.data).toEqual({...});
94
+ * }
95
+ * ```
96
+ */
97
+ function createFragmentForTest(fragmentBuilder, options) {
98
+ const { config, options: fragmentOptions = {}, deps: depsOverride, services: servicesOverride, additionalContext: additionalContextOverride } = options;
99
+ const definition = fragmentBuilder.definition;
100
+ const deps = {
101
+ ...definition.dependencies ? definition.dependencies(config, fragmentOptions) : {},
102
+ ...depsOverride
103
+ };
104
+ const services = {
105
+ ...definition.services ? definition.services(config, fragmentOptions, deps) : {},
106
+ ...servicesOverride
107
+ };
108
+ return {
109
+ config,
110
+ deps,
111
+ services,
112
+ additionalContext: {
113
+ ...definition.additionalContext,
114
+ ...fragmentOptions,
115
+ ...additionalContextOverride
116
+ },
117
+ initRoutes: (routesOrFactories, overrides) => {
118
+ return resolveRouteFactories({
119
+ config: {
120
+ ...config,
121
+ ...overrides?.config
122
+ },
123
+ deps: {
124
+ ...deps,
125
+ ...overrides?.deps
126
+ },
127
+ services: {
128
+ ...services,
129
+ ...overrides?.services
130
+ }
131
+ }, routesOrFactories);
132
+ },
133
+ handler: async (route, inputOptions) => {
134
+ const { pathParams = {}, body, query, headers } = inputOptions || {};
135
+ const searchParams = query instanceof URLSearchParams ? query : query ? new URLSearchParams(query) : new URLSearchParams();
136
+ const requestHeaders = headers instanceof Headers ? headers : headers ? new Headers(headers) : new Headers();
137
+ const inputContext = new RequestInputContext({
138
+ path: route.path,
139
+ method: route.method,
140
+ pathParams,
141
+ searchParams,
142
+ headers: requestHeaders,
143
+ body,
144
+ inputSchema: route.inputSchema,
145
+ shouldValidateInput: false
146
+ });
147
+ const outputContext = new RequestOutputContext(route.outputSchema);
148
+ return parseResponse(await route.handler(inputContext, outputContext));
149
+ }
150
+ };
151
+ }
152
+
153
+ //#endregion
154
+ export { createFragmentForTest };
155
+ //# sourceMappingURL=test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test.js","names":[],"sources":["../../src/test/test.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { FragmentDefinition } from \"../api/fragment-builder\";\nimport type { FragnoRouteConfig, HTTPMethod } from \"../api/api\";\nimport type { ExtractPathParams } from \"../api/internal/path\";\nimport { RequestInputContext } from \"../api/request-input-context\";\nimport { RequestOutputContext } from \"../api/request-output-context\";\nimport type { AnyRouteOrFactory, FlattenRouteFactories } from \"../api/route\";\nimport { resolveRouteFactories } from \"../api/route\";\nimport type { FragnoPublicConfig } from \"../api/fragment-instantiation\";\n\n/**\n * Discriminated union representing all possible test response types\n */\nexport type TestResponse<T> =\n | {\n type: \"empty\";\n status: number;\n headers: Headers;\n }\n | {\n type: \"error\";\n status: number;\n headers: Headers;\n error: { message: string; code: string };\n }\n | {\n type: \"json\";\n status: number;\n headers: Headers;\n data: T;\n }\n | {\n type: \"jsonStream\";\n status: number;\n headers: Headers;\n stream: AsyncGenerator<T>;\n };\n\n/**\n * Parse a Response object into a TestResponse discriminated union\n */\nasync function parseResponse<T>(response: Response): Promise<TestResponse<T>> {\n const status = response.status;\n const headers = response.headers;\n const contentType = headers.get(\"content-type\") || \"\";\n\n // Check for streaming response\n if (contentType.includes(\"application/x-ndjson\")) {\n return {\n type: \"jsonStream\",\n status,\n headers,\n stream: parseNDJSONStream<T>(response),\n };\n }\n\n // Parse JSON body\n const text = await response.text();\n\n // Empty response\n if (!text || text === \"null\") {\n return {\n type: \"empty\",\n status,\n headers,\n };\n }\n\n const data = JSON.parse(text);\n\n // Error response (has message and code)\n if (data && typeof data === \"object\" && \"message\" in data && \"code\" in data) {\n return {\n type: \"error\",\n status,\n headers,\n error: { message: data.message, code: data.code },\n };\n }\n\n // JSON response\n return {\n type: \"json\",\n status,\n headers,\n data: data as T,\n };\n}\n\n/**\n * Parse an NDJSON stream into an async generator\n */\nasync function* parseNDJSONStream<T>(response: Response): AsyncGenerator<T> {\n if (!response.body) {\n return;\n }\n\n const reader = response.body.getReader();\n const decoder = new TextDecoder();\n let buffer = \"\";\n\n try {\n while (true) {\n const { done, value } = await reader.read();\n\n if (done) {\n break;\n }\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split(\"\\n\");\n\n // Keep the last incomplete line in the buffer\n buffer = lines.pop() || \"\";\n\n for (const line of lines) {\n if (line.trim()) {\n yield JSON.parse(line) as T;\n }\n }\n }\n\n // Process any remaining data in the buffer\n if (buffer.trim()) {\n yield JSON.parse(buffer) as T;\n }\n } finally {\n reader.releaseLock();\n }\n}\n\n/**\n * Options for creating a test fragment\n */\nexport interface CreateFragmentForTestOptions<\n TConfig,\n TDeps,\n TServices,\n TAdditionalContext extends Record<string, unknown>,\n TOptions extends FragnoPublicConfig,\n> {\n config: TConfig;\n options?: Partial<TOptions>;\n deps?: Partial<TDeps>;\n services?: Partial<TServices>;\n additionalContext?: Partial<TAdditionalContext>;\n}\n\n/**\n * Options for calling a route handler\n */\nexport interface RouteHandlerInputOptions<\n TPath extends string,\n TInputSchema extends StandardSchemaV1 | undefined,\n> {\n pathParams?: ExtractPathParams<TPath>;\n body?: TInputSchema extends StandardSchemaV1 ? StandardSchemaV1.InferInput<TInputSchema> : never;\n query?: URLSearchParams | Record<string, string>;\n headers?: Headers | Record<string, string>;\n}\n\n/**\n * Options for overriding config/deps/services when initializing routes\n */\nexport interface InitRoutesOverrides<TConfig, TDeps, TServices> {\n config?: Partial<TConfig>;\n deps?: Partial<TDeps>;\n services?: Partial<TServices>;\n}\n\n/**\n * Fragment test instance with type-safe handler method\n */\nexport interface FragmentForTest<\n TConfig,\n TDeps,\n TServices,\n TAdditionalContext extends Record<string, unknown>,\n TOptions extends FragnoPublicConfig,\n> {\n config: TConfig;\n deps: TDeps;\n services: TServices;\n additionalContext: TAdditionalContext & TOptions;\n handler: <\n TMethod extends HTTPMethod,\n TPath extends string,\n TInputSchema extends StandardSchemaV1 | undefined,\n TOutputSchema extends StandardSchemaV1 | undefined,\n TErrorCode extends string,\n TQueryParameters extends string,\n >(\n route: FragnoRouteConfig<\n TMethod,\n TPath,\n TInputSchema,\n TOutputSchema,\n TErrorCode,\n TQueryParameters\n >,\n inputOptions?: RouteHandlerInputOptions<TPath, TInputSchema>,\n ) => Promise<\n TestResponse<\n TOutputSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TOutputSchema> : unknown\n >\n >;\n initRoutes: <const TRoutesOrFactories extends readonly AnyRouteOrFactory[]>(\n routesOrFactories: TRoutesOrFactories,\n overrides?: InitRoutesOverrides<TConfig, TDeps, TServices>,\n ) => FlattenRouteFactories<TRoutesOrFactories>;\n}\n\n/**\n * Create a fragment instance for testing with optional dependency and service overrides\n *\n * @param fragmentBuilder - The fragment builder with definition and required options\n * @param options - Configuration and optional overrides for deps/services\n * @returns A fragment test instance with a type-safe handler method\n *\n * @example\n * ```typescript\n * const fragment = createFragmentForTest(chatnoDefinition, {\n * config: { openaiApiKey: \"test-key\" },\n * options: { mountRoute: \"/api/chatno\" },\n * services: {\n * generateStreamMessages: mockGenerator\n * }\n * });\n *\n * // Initialize routes with fragment's config/deps/services\n * const [route] = fragment.initRoutes(routes);\n *\n * // Or override specific config/deps/services for certain routes\n * const [route] = fragment.initRoutes(routes, {\n * services: { mockService: mockImplementation }\n * });\n *\n * const response = await fragment.handler(route, {\n * pathParams: { id: \"123\" },\n * body: { message: \"Hello\" }\n * });\n *\n * if (response.type === 'json') {\n * expect(response.data).toEqual({...});\n * }\n * ```\n */\nexport function createFragmentForTest<\n TConfig,\n TDeps,\n TServices extends Record<string, unknown>,\n TAdditionalContext extends Record<string, unknown>,\n TOptions extends FragnoPublicConfig,\n>(\n fragmentBuilder: {\n definition: FragmentDefinition<TConfig, TDeps, TServices, TAdditionalContext>;\n $requiredOptions: TOptions;\n },\n options: CreateFragmentForTestOptions<TConfig, TDeps, TServices, TAdditionalContext, TOptions>,\n): FragmentForTest<TConfig, TDeps, TServices, TAdditionalContext, TOptions> {\n const {\n config,\n options: fragmentOptions = {} as TOptions,\n deps: depsOverride,\n services: servicesOverride,\n additionalContext: additionalContextOverride,\n } = options;\n\n // Create deps from definition or use empty object\n const definition = fragmentBuilder.definition;\n const baseDeps = definition.dependencies\n ? definition.dependencies(config, fragmentOptions)\n : ({} as TDeps);\n\n // Merge deps with overrides\n const deps = { ...baseDeps, ...depsOverride } as TDeps;\n\n // Create services from definition or use empty object\n const baseServices = definition.services\n ? definition.services(config, fragmentOptions, deps)\n : ({} as TServices);\n\n // Merge services with overrides\n const services = { ...baseServices, ...servicesOverride } as TServices;\n\n // Merge additional context with options\n const additionalContext = {\n ...definition.additionalContext,\n ...fragmentOptions,\n ...additionalContextOverride,\n } as TAdditionalContext & TOptions;\n\n return {\n config,\n deps,\n services,\n additionalContext,\n initRoutes: <const TRoutesOrFactories extends readonly AnyRouteOrFactory[]>(\n routesOrFactories: TRoutesOrFactories,\n overrides?: InitRoutesOverrides<TConfig, TDeps, TServices>,\n ): FlattenRouteFactories<TRoutesOrFactories> => {\n // Merge overrides with base config/deps/services\n const routeContext = {\n config: { ...config, ...overrides?.config } as TConfig,\n deps: { ...deps, ...overrides?.deps } as TDeps,\n services: { ...services, ...overrides?.services } as TServices,\n };\n return resolveRouteFactories(routeContext, routesOrFactories);\n },\n handler: async <\n TMethod extends HTTPMethod,\n TPath extends string,\n TInputSchema extends StandardSchemaV1 | undefined,\n TOutputSchema extends StandardSchemaV1 | undefined,\n TErrorCode extends string,\n TQueryParameters extends string,\n >(\n route: FragnoRouteConfig<\n TMethod,\n TPath,\n TInputSchema,\n TOutputSchema,\n TErrorCode,\n TQueryParameters\n >,\n inputOptions?: RouteHandlerInputOptions<TPath, TInputSchema>,\n ): Promise<\n TestResponse<\n TOutputSchema extends StandardSchemaV1\n ? StandardSchemaV1.InferOutput<TOutputSchema>\n : unknown\n >\n > => {\n const {\n pathParams = {} as ExtractPathParams<TPath>,\n body,\n query,\n headers,\n } = inputOptions || {};\n\n // Convert query to URLSearchParams if needed\n const searchParams =\n query instanceof URLSearchParams\n ? query\n : query\n ? new URLSearchParams(query)\n : new URLSearchParams();\n\n // Convert headers to Headers if needed\n const requestHeaders =\n headers instanceof Headers ? headers : headers ? new Headers(headers) : new Headers();\n\n // Construct RequestInputContext\n const inputContext = new RequestInputContext<TPath, TInputSchema>({\n path: route.path,\n method: route.method,\n pathParams,\n searchParams,\n headers: requestHeaders,\n body,\n inputSchema: route.inputSchema,\n shouldValidateInput: false, // Skip validation in tests\n });\n\n // Construct RequestOutputContext\n const outputContext = new RequestOutputContext(route.outputSchema);\n\n // Call the route handler\n const response = await route.handler(inputContext, outputContext);\n\n // Parse and return the response\n return parseResponse<\n TOutputSchema extends StandardSchemaV1\n ? StandardSchemaV1.InferOutput<TOutputSchema>\n : unknown\n >(response);\n },\n };\n}\n"],"mappings":";;;;;;;AAyCA,eAAe,cAAiB,UAA8C;CAC5E,MAAM,SAAS,SAAS;CACxB,MAAM,UAAU,SAAS;AAIzB,MAHoB,QAAQ,IAAI,eAAe,IAAI,IAGnC,SAAS,uBAAuB,CAC9C,QAAO;EACL,MAAM;EACN;EACA;EACA,QAAQ,kBAAqB,SAAS;EACvC;CAIH,MAAM,OAAO,MAAM,SAAS,MAAM;AAGlC,KAAI,CAAC,QAAQ,SAAS,OACpB,QAAO;EACL,MAAM;EACN;EACA;EACD;CAGH,MAAM,OAAO,KAAK,MAAM,KAAK;AAG7B,KAAI,QAAQ,OAAO,SAAS,YAAY,aAAa,QAAQ,UAAU,KACrE,QAAO;EACL,MAAM;EACN;EACA;EACA,OAAO;GAAE,SAAS,KAAK;GAAS,MAAM,KAAK;GAAM;EAClD;AAIH,QAAO;EACL,MAAM;EACN;EACA;EACM;EACP;;;;;AAMH,gBAAgB,kBAAqB,UAAuC;AAC1E,KAAI,CAAC,SAAS,KACZ;CAGF,MAAM,SAAS,SAAS,KAAK,WAAW;CACxC,MAAM,UAAU,IAAI,aAAa;CACjC,IAAI,SAAS;AAEb,KAAI;AACF,SAAO,MAAM;GACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAE3C,OAAI,KACF;AAGF,aAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,MAAM,CAAC;GACjD,MAAM,QAAQ,OAAO,MAAM,KAAK;AAGhC,YAAS,MAAM,KAAK,IAAI;AAExB,QAAK,MAAM,QAAQ,MACjB,KAAI,KAAK,MAAM,CACb,OAAM,KAAK,MAAM,KAAK;;AAM5B,MAAI,OAAO,MAAM,CACf,OAAM,KAAK,MAAM,OAAO;WAElB;AACR,SAAO,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwHxB,SAAgB,sBAOd,iBAIA,SAC0E;CAC1E,MAAM,EACJ,QACA,SAAS,kBAAkB,EAAE,EAC7B,MAAM,cACN,UAAU,kBACV,mBAAmB,8BACjB;CAGJ,MAAM,aAAa,gBAAgB;CAMnC,MAAM,OAAO;EAAE,GALE,WAAW,eACxB,WAAW,aAAa,QAAQ,gBAAgB,GAC/C,EAAE;EAGqB,GAAG;EAAc;CAQ7C,MAAM,WAAW;EAAE,GALE,WAAW,WAC5B,WAAW,SAAS,QAAQ,iBAAiB,KAAK,GACjD,EAAE;EAG6B,GAAG;EAAkB;AASzD,QAAO;EACL;EACA;EACA;EACA,mBAVwB;GACxB,GAAG,WAAW;GACd,GAAG;GACH,GAAG;GACJ;EAOC,aACE,mBACA,cAC8C;AAO9C,UAAO,sBALc;IACnB,QAAQ;KAAE,GAAG;KAAQ,GAAG,WAAW;KAAQ;IAC3C,MAAM;KAAE,GAAG;KAAM,GAAG,WAAW;KAAM;IACrC,UAAU;KAAE,GAAG;KAAU,GAAG,WAAW;KAAU;IAClD,EAC0C,kBAAkB;;EAE/D,SAAS,OAQP,OAQA,iBAOG;GACH,MAAM,EACJ,aAAa,EAAE,EACf,MACA,OACA,YACE,gBAAgB,EAAE;GAGtB,MAAM,eACJ,iBAAiB,kBACb,QACA,QACE,IAAI,gBAAgB,MAAM,GAC1B,IAAI,iBAAiB;GAG7B,MAAM,iBACJ,mBAAmB,UAAU,UAAU,UAAU,IAAI,QAAQ,QAAQ,GAAG,IAAI,SAAS;GAGvF,MAAM,eAAe,IAAI,oBAAyC;IAChE,MAAM,MAAM;IACZ,QAAQ,MAAM;IACd;IACA;IACA,SAAS;IACT;IACA,aAAa,MAAM;IACnB,qBAAqB;IACtB,CAAC;GAGF,MAAM,gBAAgB,IAAI,qBAAqB,MAAM,aAAa;AAMlE,UAAO,cAHU,MAAM,MAAM,QAAQ,cAAc,cAAc,CAOtD;;EAEd"}
package/package.json CHANGED
@@ -1,69 +1,63 @@
1
1
  {
2
2
  "name": "@fragno-dev/core",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "exports": {
5
5
  ".": {
6
- "bun": "./src/mod.ts",
7
6
  "development": "./src/mod.ts",
8
7
  "types": "./dist/mod.d.ts",
9
8
  "default": "./dist/mod.js"
10
9
  },
11
10
  "./api": {
12
- "bun": "./src/api/api.ts",
13
11
  "development": "./src/api/api.ts",
14
12
  "types": "./dist/api/api.d.ts",
15
13
  "default": "./dist/api/api.js"
16
14
  },
15
+ "./test": {
16
+ "development": "./src/test/test.ts",
17
+ "types": "./dist/test/test.d.ts",
18
+ "default": "./dist/test/test.js"
19
+ },
17
20
  "./api/fragment-builder": {
18
- "bun": "./src/api/fragment-builder.ts",
19
21
  "development": "./src/api/fragment-builder.ts",
20
22
  "types": "./dist/api/fragment-builder.d.ts",
21
23
  "default": "./dist/api/fragment-builder.js"
22
24
  },
23
25
  "./api/fragment-instantiation": {
24
- "bun": "./src/api/fragment-instantiation.ts",
25
26
  "development": "./src/api/fragment-instantiation.ts",
26
27
  "types": "./dist/api/fragment-instantiation.d.ts",
27
28
  "default": "./dist/api/fragment-instantiation.js"
28
29
  },
29
30
  "./client": {
30
- "bun": "./src/client/client.ts",
31
31
  "development": "./src/client/client.ts",
32
32
  "types": "./dist/client/client.d.ts",
33
33
  "default": "./dist/client/client.js"
34
34
  },
35
35
  "./react": {
36
- "bun": "./src/client/react.ts",
37
36
  "development": "./src/client/react.ts",
38
37
  "types": "./dist/client/react.d.ts",
39
38
  "default": "./dist/client/react.js"
40
39
  },
41
40
  "./vanilla": {
42
- "bun": "./src/client/vanilla.ts",
43
41
  "development": "./src/client/vanilla.ts",
44
42
  "types": "./dist/client/vanilla.d.ts",
45
43
  "default": "./dist/client/vanilla.js"
46
44
  },
47
45
  "./vue": {
48
- "bun": "./src/client/vue.ts",
49
46
  "development": "./src/client/vue.ts",
50
47
  "types": "./dist/client/vue.d.ts",
51
48
  "default": "./dist/client/vue.js"
52
49
  },
53
50
  "./svelte": {
54
- "bun": "./src/client/client.svelte.ts",
55
51
  "development": "./src/client/client.svelte.ts",
56
52
  "types": "./dist/client/client.svelte.d.ts",
57
53
  "default": "./dist/client/client.svelte.js"
58
54
  },
59
55
  "./solid": {
60
- "bun": "./src/client/solid.ts",
61
56
  "development": "./src/client/solid.ts",
62
57
  "types": "./dist/client/solid.d.ts",
63
58
  "default": "./dist/client/solid.js"
64
59
  },
65
60
  "./react-ssr": {
66
- "bun": "./src/integrations/react-ssr.ts",
67
61
  "development": "./src/integrations/react-ssr.ts",
68
62
  "types": "./dist/integrations/react-ssr.d.ts",
69
63
  "default": "./dist/integrations/react-ssr.js"
@@ -73,13 +67,6 @@
73
67
  "main": "./dist/mod.js",
74
68
  "module": "./dist/mod.js",
75
69
  "types": "./dist/mod.d.ts",
76
- "scripts": {
77
- "build": "tsdown",
78
- "build:watch": "tsdown --watch",
79
- "types:check": "tsc --noEmit",
80
- "test": "vitest run",
81
- "test:watch": "vitest --watch"
82
- },
83
70
  "type": "module",
84
71
  "dependencies": {
85
72
  "@nanostores/query": "^0.3.4",
@@ -89,8 +76,6 @@
89
76
  "rou3": "^0.7.3"
90
77
  },
91
78
  "devDependencies": {
92
- "@fragno-private/typescript-config": "0.0.1",
93
- "@fragno-private/vitest-config": "0.0.0",
94
79
  "@sveltejs/vite-plugin-svelte": "^6.2.0",
95
80
  "@testing-library/react": "^16.3.0",
96
81
  "@testing-library/svelte": "^5.2.8",
@@ -106,7 +91,9 @@
106
91
  "solid-js": "^1.9.3",
107
92
  "vitest": "^3.2.4",
108
93
  "vue": "^3",
109
- "zod": "^4.0.5"
94
+ "zod": "^4.0.5",
95
+ "@fragno-private/vitest-config": "0.0.0",
96
+ "@fragno-private/typescript-config": "0.0.1"
110
97
  },
111
98
  "peerDependencies": {
112
99
  "react": "^19.0.0",
@@ -134,5 +121,12 @@
134
121
  "directory": "packages/fragno"
135
122
  },
136
123
  "homepage": "https://fragno.dev",
137
- "license": "MIT"
138
- }
124
+ "license": "MIT",
125
+ "scripts": {
126
+ "build": "tsdown",
127
+ "build:watch": "tsdown --watch",
128
+ "types:check": "tsc --noEmit",
129
+ "test": "vitest run",
130
+ "test:watch": "vitest --watch"
131
+ }
132
+ }
@@ -73,7 +73,6 @@ export class FragmentBuilder<
73
73
  });
74
74
  }
75
75
  }
76
-
77
76
  export function defineFragment<TConfig = {}>(name: string): FragmentBuilder<TConfig, {}, {}, {}> {
78
77
  return new FragmentBuilder({
79
78
  name,