heliumts 0.9.6 → 0.10.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/README.md +39 -14
- package/dist/bin/helium.js +19 -10
- package/dist/bin/helium.js.map +1 -1
- package/dist/client/Router.d.ts.map +1 -1
- package/dist/client/Router.js +2 -4
- package/dist/client/Router.js.map +1 -1
- package/dist/client/callMethod.d.ts +8 -0
- package/dist/client/callMethod.d.ts.map +1 -0
- package/dist/client/callMethod.js +9 -0
- package/dist/client/callMethod.js.map +1 -0
- package/dist/client/index.d.ts +3 -2
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +2 -1
- package/dist/client/index.js.map +1 -1
- package/dist/client/rpcClient.d.ts +7 -37
- package/dist/client/rpcClient.d.ts.map +1 -1
- package/dist/client/rpcClient.js +118 -749
- package/dist/client/rpcClient.js.map +1 -1
- package/dist/client/rpcStreaming.d.ts +10 -0
- package/dist/client/rpcStreaming.d.ts.map +1 -0
- package/dist/client/rpcStreaming.js +125 -0
- package/dist/client/rpcStreaming.js.map +1 -0
- package/dist/client/useStreaming.d.ts +26 -0
- package/dist/client/useStreaming.d.ts.map +1 -0
- package/dist/client/useStreaming.js +126 -0
- package/dist/client/useStreaming.js.map +1 -0
- package/dist/runtime/protocol.d.ts +14 -0
- package/dist/runtime/protocol.d.ts.map +1 -1
- package/dist/runtime/protocol.js +3 -1
- package/dist/runtime/protocol.js.map +1 -1
- package/dist/server/config.d.ts +16 -101
- package/dist/server/config.d.ts.map +1 -1
- package/dist/server/config.js +5 -27
- package/dist/server/config.js.map +1 -1
- package/dist/server/context.d.ts +8 -6
- package/dist/server/context.d.ts.map +1 -1
- package/dist/server/context.js.map +1 -1
- package/dist/server/defineWorker.d.ts +1 -1
- package/dist/server/defineWorker.d.ts.map +1 -1
- package/dist/server/defineWorker.js +2 -1
- package/dist/server/defineWorker.js.map +1 -1
- package/dist/server/devServer.d.ts +1 -1
- package/dist/server/devServer.d.ts.map +1 -1
- package/dist/server/devServer.js +13 -250
- package/dist/server/devServer.js.map +1 -1
- package/dist/server/httpCompression.d.ts +8 -0
- package/dist/server/httpCompression.d.ts.map +1 -0
- package/dist/server/httpCompression.js +58 -0
- package/dist/server/httpCompression.js.map +1 -0
- package/dist/server/httpRouter.d.ts.map +1 -1
- package/dist/server/httpRouter.js +5 -2
- package/dist/server/httpRouter.js.map +1 -1
- package/dist/server/httpRpc.d.ts +10 -0
- package/dist/server/httpRpc.d.ts.map +1 -0
- package/dist/server/httpRpc.js +186 -0
- package/dist/server/httpRpc.js.map +1 -0
- package/dist/server/prodServer.d.ts +3 -1
- package/dist/server/prodServer.d.ts.map +1 -1
- package/dist/server/prodServer.js +36 -229
- package/dist/server/prodServer.js.map +1 -1
- package/dist/server/rateLimiter.d.ts +6 -36
- package/dist/server/rateLimiter.d.ts.map +1 -1
- package/dist/server/rateLimiter.js +18 -125
- package/dist/server/rateLimiter.js.map +1 -1
- package/dist/server/requestSignal.d.ts +10 -0
- package/dist/server/requestSignal.d.ts.map +1 -0
- package/dist/server/requestSignal.js +79 -0
- package/dist/server/requestSignal.js.map +1 -0
- package/dist/server/rpcRegistry.d.ts +10 -18
- package/dist/server/rpcRegistry.d.ts.map +1 -1
- package/dist/server/rpcRegistry.js +181 -269
- package/dist/server/rpcRegistry.js.map +1 -1
- package/dist/server/serializer.js +12 -6
- package/dist/server/serializer.js.map +1 -1
- package/dist/vite/heliumPlugin.d.ts.map +1 -1
- package/dist/vite/heliumPlugin.js +77 -43
- package/dist/vite/heliumPlugin.js.map +1 -1
- package/dist/vite/ssg.d.ts.map +1 -1
- package/dist/vite/ssg.js +20 -1
- package/dist/vite/ssg.js.map +1 -1
- package/package.json +2 -4
package/dist/client/index.d.ts
CHANGED
|
@@ -3,8 +3,10 @@ export type { AppShellProps, LinkProps, RouterNavigationOptions } from "./Router
|
|
|
3
3
|
export { AppRouter, Link, Redirect, RouterContext, useRouter } from "./Router.js";
|
|
4
4
|
export type { LayoutProps } from "./routerManifest.js";
|
|
5
5
|
export type { PageTransitionProps } from "./transitions.js";
|
|
6
|
+
export { callMethod } from "./callMethod.js";
|
|
6
7
|
export * from "./useCall.js";
|
|
7
8
|
export * from "./useFetch.js";
|
|
9
|
+
export * from "./useStreaming.js";
|
|
8
10
|
export { RpcError } from "./RpcError.js";
|
|
9
11
|
/**
|
|
10
12
|
* Returns `true` when the current code is executing during server-side rendering.
|
|
@@ -12,7 +14,6 @@ export { RpcError } from "./RpcError.js";
|
|
|
12
14
|
* while still rendering providers and structural content for SSR.
|
|
13
15
|
*/
|
|
14
16
|
export declare function isSSR(): boolean;
|
|
15
|
-
export type {
|
|
16
|
-
export { getRpcTransport, isAutoHttpOnMobileEnabled, preconnect } from "./rpcClient.js";
|
|
17
|
+
export type { RpcResult } from "./rpcClient.js";
|
|
17
18
|
export * from "./types.js";
|
|
18
19
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAK7E,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAK7E,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,cAAc,YAAY,CAAC"}
|
package/dist/client/index.js
CHANGED
|
@@ -3,8 +3,10 @@ export { getPublicEnv, getPublicEnvValue, isDevEnvironment } from "./env.js";
|
|
|
3
3
|
installStaleClientRecovery();
|
|
4
4
|
export { AppRouter, Link, Redirect, RouterContext, useRouter } from "./Router.js";
|
|
5
5
|
// RPC hooks for data fetching and mutations
|
|
6
|
+
export { callMethod } from "./callMethod.js";
|
|
6
7
|
export * from "./useCall.js";
|
|
7
8
|
export * from "./useFetch.js";
|
|
9
|
+
export * from "./useStreaming.js";
|
|
8
10
|
// RPC error type
|
|
9
11
|
export { RpcError } from "./RpcError.js";
|
|
10
12
|
/**
|
|
@@ -15,7 +17,6 @@ export { RpcError } from "./RpcError.js";
|
|
|
15
17
|
export function isSSR() {
|
|
16
18
|
return typeof window === "undefined";
|
|
17
19
|
}
|
|
18
|
-
export { getRpcTransport, isAutoHttpOnMobileEnabled, preconnect } from "./rpcClient.js";
|
|
19
20
|
// Type definitions
|
|
20
21
|
export * from "./types.js";
|
|
21
22
|
// Internal - rpcClient and cache are used by hooks, not exposed to users
|
package/dist/client/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7E,0BAA0B,EAAE,CAAC;AAI7B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOlF,4CAA4C;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7E,0BAA0B,EAAE,CAAC;AAI7B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOlF,4CAA4C;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAElC,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,KAAK;IACjB,OAAO,OAAO,MAAM,KAAK,WAAW,CAAC;AACzC,CAAC;AAID,mBAAmB;AACnB,cAAc,YAAY,CAAC;AAE3B,yEAAyE","sourcesContent":["import { installStaleClientRecovery } from \"./staleRecovery.js\";\n\nexport { getPublicEnv, getPublicEnvValue, isDevEnvironment } from \"./env.js\";\n\ninstallStaleClientRecovery();\n\n// Router components and hooks\nexport type { AppShellProps, LinkProps, RouterNavigationOptions } from \"./Router.js\";\nexport { AppRouter, Link, Redirect, RouterContext, useRouter } from \"./Router.js\";\nexport type { LayoutProps } from \"./routerManifest.js\";\n\n// React 18+ page transitions (separate module for better tree-shaking)\n// Import from \"heliumts/client/transitions\" to ensure they're only bundled when used\nexport type { PageTransitionProps } from \"./transitions.js\";\n\n// RPC hooks for data fetching and mutations\nexport { callMethod } from \"./callMethod.js\";\nexport * from \"./useCall.js\";\nexport * from \"./useFetch.js\";\nexport * from \"./useStreaming.js\";\n\n// RPC error type\nexport { RpcError } from \"./RpcError.js\";\n\n/**\n * Returns `true` when the current code is executing during server-side rendering.\n * Use this in layouts or components to skip browser-only logic (e.g. auth guards)\n * while still rendering providers and structural content for SSR.\n */\nexport function isSSR(): boolean {\n return typeof window === \"undefined\";\n}\n\nexport type { RpcResult } from \"./rpcClient.js\";\n\n// Type definitions\nexport * from \"./types.js\";\n\n// Internal - rpcClient and cache are used by hooks, not exposed to users\n"]}
|
|
@@ -1,42 +1,12 @@
|
|
|
1
|
-
import type { RpcStats } from "../runtime/protocol.js";
|
|
1
|
+
import type { RpcRequest, RpcStats } from "../runtime/protocol.js";
|
|
2
2
|
export type RpcResult<T> = {
|
|
3
3
|
data: T;
|
|
4
4
|
stats: RpcStats;
|
|
5
5
|
};
|
|
6
|
-
export
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
* - "websocket": Uses persistent WebSocket connection (lower latency on desktop/low-latency networks)
|
|
13
|
-
* - "auto": Automatically selects based on connection type
|
|
14
|
-
*/
|
|
15
|
-
export type RpcTransport = "http" | "websocket" | "auto";
|
|
16
|
-
/**
|
|
17
|
-
* Get the configured RPC transport mode (from helium.config.js).
|
|
18
|
-
*/
|
|
19
|
-
export declare function getRpcTransport(): RpcTransport;
|
|
20
|
-
/**
|
|
21
|
-
* Check if auto HTTP on mobile is enabled (from helium.config.js).
|
|
22
|
-
*/
|
|
23
|
-
export declare function isAutoHttpOnMobileEnabled(): boolean;
|
|
24
|
-
export declare function isMobileRpcDevice(): boolean;
|
|
25
|
-
/**
|
|
26
|
-
* Make an RPC call using the appropriate transport.
|
|
27
|
-
* Automatically selects HTTP or WebSocket based on network conditions and configuration.
|
|
28
|
-
*
|
|
29
|
-
* Includes automatic retry logic: if a call fails due to a connection error
|
|
30
|
-
* (e.g. stale WebSocket after mobile browser was backgrounded), the client
|
|
31
|
-
* forces a fresh connection (with a new token) and retries once.
|
|
32
|
-
*/
|
|
33
|
-
export declare function rpcCall<TResult = unknown, TArgs = unknown>(methodId: string, args?: TArgs): Promise<RpcResult<TResult>>;
|
|
34
|
-
export declare function rpcCallWithOptions<TResult = unknown, TArgs = unknown>(methodId: string, args: TArgs | undefined, options: RpcCallOptions): Promise<RpcResult<TResult>>;
|
|
35
|
-
/**
|
|
36
|
-
* Pre-establishes the WebSocket connection.
|
|
37
|
-
* Call this early (e.g., on page load) to avoid connection latency on first RPC call.
|
|
38
|
-
* This is especially beneficial on high-latency networks like mobile LTE.
|
|
39
|
-
* Note: Only effective when using WebSocket transport (not HTTP transport).
|
|
40
|
-
*/
|
|
41
|
-
export declare function preconnect(): void;
|
|
6
|
+
export declare function createRpcRequest<TArgs>(method: string, args?: TArgs): RpcRequest;
|
|
7
|
+
/** Shared HTTP request authentication for unary and streaming calls. */
|
|
8
|
+
export declare function postRpc(endpoint: "/__helium__/rpc" | "/__helium__/stream", request: RpcRequest | RpcRequest[], signal: AbortSignal): Promise<Response>;
|
|
9
|
+
export declare function isRpcStats(value: unknown): value is RpcStats;
|
|
10
|
+
/** Call an RPC method over HTTP; simultaneous calls share capped batch envelopes. */
|
|
11
|
+
export declare function rpcCall<TResult = unknown, TArgs = unknown>(method: string, args?: TArgs): Promise<RpcResult<TResult>>;
|
|
42
12
|
//# sourceMappingURL=rpcClient.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rpcClient.d.ts","sourceRoot":"","sources":["../../src/client/rpcClient.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"rpcClient.d.ts","sourceRoot":"","sources":["../../src/client/rpcClient.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAe,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGhF,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAmBxD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,GAAG,UAAU,CAEhF;AA2DD,wEAAwE;AACxE,wBAAsB,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,oBAAoB,EAAE,OAAO,EAAE,UAAU,GAAG,UAAU,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAwB5J;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAM5D;AA6CD,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAerH"}
|