@ziex/cli 0.1.0-dev.865 → 0.1.0-test.1
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/package.json +10 -29
- package/README.md +0 -195
- package/app.d.ts +0 -112
- package/aws-lambda/index.d.ts +0 -96
- package/aws-lambda/index.js +0 -126
- package/build.zig +0 -5
- package/build.zig.zon +0 -7
- package/cloudflare/app.d.ts +0 -2
- package/cloudflare/do.d.ts +0 -48
- package/cloudflare/index.d.ts +0 -4
- package/cloudflare/index.js +0 -1707
- package/cloudflare/kv.d.ts +0 -2
- package/cloudflare/worker.d.ts +0 -3
- package/index.d.ts +0 -2
- package/index.js +0 -739
- package/kv.d.ts +0 -27
- package/react/dom.d.ts +0 -21
- package/react/index.d.ts +0 -2
- package/react/index.js +0 -144
- package/react/types.d.ts +0 -190
- package/runtime.d.ts +0 -70
- package/vercel/index.d.ts +0 -26
- package/vercel/index.js +0 -18
- package/wasi.d.ts +0 -61
- package/wasm/core.d.ts +0 -78
- package/wasm/dom.d.ts +0 -4
- package/wasm/index.d.ts +0 -46
- package/wasm/index.js +0 -895
- package/wasm/init.d.ts +0 -1
- package/wasm/init.js +0 -873
- package/wasm/types.d.ts +0 -1
- package/wasm/wasi.d.ts +0 -28
- package/zx.d.ts +0 -1
package/package.json
CHANGED
|
@@ -1,22 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ziex/cli",
|
|
3
|
-
"version": "0.1.0-
|
|
3
|
+
"version": "0.1.0-test.1",
|
|
4
4
|
"description": "ZX is a framework for building web applications with Zig.",
|
|
5
|
-
"main": "index.
|
|
5
|
+
"main": "index.cjs",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"bin": {
|
|
8
8
|
"ziex": "bin/ziex",
|
|
9
9
|
"zx": "bin/ziex"
|
|
10
10
|
},
|
|
11
|
-
"exports": {
|
|
12
|
-
".": "./index.js",
|
|
13
|
-
"./react": "./react/index.js",
|
|
14
|
-
"./wasm": "./wasm/index.js",
|
|
15
|
-
"./wasm/init": "./wasm/init.js",
|
|
16
|
-
"./cloudflare": "./cloudflare/index.js",
|
|
17
|
-
"./aws-lambda": "./aws-lambda/index.js",
|
|
18
|
-
"./vercel": "./vercel/index.js"
|
|
19
|
-
},
|
|
20
11
|
"homepage": "https://ziex.dev",
|
|
21
12
|
"repository": {
|
|
22
13
|
"type": "git",
|
|
@@ -37,24 +28,14 @@
|
|
|
37
28
|
"author": "Nurul Huda (Apon) <me@nurulhudaapon.com>",
|
|
38
29
|
"license": "MIT",
|
|
39
30
|
"scripts": {
|
|
40
|
-
"postinstall": "node install.
|
|
41
|
-
},
|
|
42
|
-
"peerDependenciesMeta": {
|
|
43
|
-
"react": {
|
|
44
|
-
"optional": true
|
|
45
|
-
},
|
|
46
|
-
"react-dom": {
|
|
47
|
-
"optional": true
|
|
48
|
-
}
|
|
31
|
+
"postinstall": "node install.cjs"
|
|
49
32
|
},
|
|
50
33
|
"optionalDependencies": {
|
|
51
|
-
"@ziex/cli-darwin-arm64": "0.1.0-dev.
|
|
52
|
-
"@ziex/cli-darwin-x64": "0.1.0-dev.
|
|
53
|
-
"@ziex/cli-linux-x64": "0.1.0-dev.
|
|
54
|
-
"@ziex/cli-linux-arm64": "0.1.0-dev.
|
|
55
|
-
"@ziex/cli-win32-x64": "0.1.0-dev.
|
|
56
|
-
"@ziex/cli-win32-arm64": "0.1.0-dev.
|
|
57
|
-
}
|
|
58
|
-
"module": "index.js",
|
|
59
|
-
"types": "index.d.ts"
|
|
34
|
+
"@ziex/cli-darwin-arm64": "0.1.0-dev.865",
|
|
35
|
+
"@ziex/cli-darwin-x64": "0.1.0-dev.865",
|
|
36
|
+
"@ziex/cli-linux-x64": "0.1.0-dev.865",
|
|
37
|
+
"@ziex/cli-linux-arm64": "0.1.0-dev.865",
|
|
38
|
+
"@ziex/cli-win32-x64": "0.1.0-dev.865",
|
|
39
|
+
"@ziex/cli-win32-arm64": "0.1.0-dev.865"
|
|
40
|
+
}
|
|
60
41
|
}
|
package/README.md
DELETED
|
@@ -1,195 +0,0 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<img src="https://raw.githubusercontent.com/ziex-dev/branding/main/banner.svg" alt="Ziex banner" width="100%" />
|
|
3
|
-
</p>
|
|
4
|
-
|
|
5
|
-
A full-stack web framework for Zig. Write declarative UI components using familiar JSX patterns, transpiled to efficient Zig code.
|
|
6
|
-
|
|
7
|
-
Ziex combines the power and performance of Zig with the expressiveness of JSX, enabling you to build fast, type-safe web applications.
|
|
8
|
-
|
|
9
|
-
**[Documentation →](https://ziex.dev/learn)**
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
> **Note:** Most of the API and syntax are finalized and stable, and server-side rendering (SSR) features are production-ready, Ziex continues to evolve with ongoing improvements to client-side rendering and state management. You can start using the documented features today, as they are stable and unlikely to change. Areas still under development are not yet documented and will be added as they mature.
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
## Installation
|
|
17
|
-
|
|
18
|
-
##### Linux/macOS
|
|
19
|
-
```bash
|
|
20
|
-
curl -fsSL https://ziex.dev/install | bash
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
##### Windows
|
|
24
|
-
```powershell
|
|
25
|
-
powershell -c "irm ziex.dev/install.ps1 | iex"
|
|
26
|
-
|
|
27
|
-
```
|
|
28
|
-
##### Installing Zig
|
|
29
|
-
```bash
|
|
30
|
-
brew install zig # macOS
|
|
31
|
-
winget install -e --id zig.zig # Windows
|
|
32
|
-
```
|
|
33
|
-
[_See for other platforms →_](https://ziglang.org/learn/getting-started/)
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
## At a Glance
|
|
37
|
-
|
|
38
|
-
```tsx site/pages/examples/playground.zx
|
|
39
|
-
pub fn Playground(allocator: zx.Allocator) zx.Component {
|
|
40
|
-
const is_loading = true;
|
|
41
|
-
var i: usize = 0;
|
|
42
|
-
|
|
43
|
-
return (
|
|
44
|
-
<main @allocator={allocator}>
|
|
45
|
-
<h1>Hello, Ziex!</h1>
|
|
46
|
-
|
|
47
|
-
{for (users) |user| (
|
|
48
|
-
<Profile name={user.name} age={user.age} role={user.role} />
|
|
49
|
-
)}
|
|
50
|
-
|
|
51
|
-
{if (is_loading) (<p>Loading...</p>) else (<p>Loaded</p>)}
|
|
52
|
-
|
|
53
|
-
{while (i < 5) : (i += 1) (<i>{i}</i>)}
|
|
54
|
-
</main>
|
|
55
|
-
);
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
fn Profile(ctx: *zx.ComponentCtx(User)) zx.Component {
|
|
59
|
-
return (
|
|
60
|
-
<div @allocator={ctx.allocator}>
|
|
61
|
-
<h3>{ctx.props.name}</h3>
|
|
62
|
-
<div>{ctx.props.age}</div>
|
|
63
|
-
<strong>
|
|
64
|
-
{switch (ctx.props.role) {
|
|
65
|
-
.admin => "Admin",
|
|
66
|
-
.member => "Member",
|
|
67
|
-
}}
|
|
68
|
-
</strong>
|
|
69
|
-
</div>
|
|
70
|
-
);
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
const User = struct { name: []const u8, age: u32, role: enum { admin, member } };
|
|
74
|
-
|
|
75
|
-
const users = [_]User{
|
|
76
|
-
.{ .name = "John", .age = 20, .role = .admin },
|
|
77
|
-
.{ .name = "Jane", .age = 21, .role = .member },
|
|
78
|
-
};
|
|
79
|
-
|
|
80
|
-
const zx = @import("zx");
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
Try this in [Playground →](https://ziex.dev/playground#data=eF59U01vnDAQ_StTTtAiyGZVqSKAEuVSVa2USy8NUUTAu2sJbGQgoUv83ztjlo-y2_rCfLx5zMyze-uhSH_vlWxF7h07K7Cq9gV2AuawnRaFzNJGqgCOnXc3eg5597KspGCigT4RgCeTom6A18-FTHMu9hBBo1p2M2RfUwU8gLbmR4aZKwwPCcWaVgmwB49OWKZcwO3086ifTB3PMAM9bOKvDLMu_OKs-xD6GBiZx9PvpAK7rZmqHXin7_vydxPXg5I7XjAQacminnAemRrS_eijpUHJYvTJ1OCvunL0WQt8B_a8GgfssIq_D47neaFfxQ6womZTguUmeM70dqAebQ4hfHYgIOtTBBui5HHPdehzUzYWhD6t89Shg2s3lKTzMK6dNV0AH5eK3jed_RPHcy4LfUGxnL_-JRhyev8RbRsbRKVkVQ87RuG2axiSLnG0-9Cn4ApXN0qK_SpKp6_feJMdwJ5JSDBnHGR9vDQv8eZFMSTWHZmJ5f4DWbLyhakB-sPYF7Far3r1z5pdjjTJM7wl0gDfCpa0GW7fXMwAHp-GbPvFpZuJb2p77ZpLGQATbYlAM4cLpyY16JuZ1LwDZH18fiL-0yq8HowQmEisb_JAowOtHAPXV2gSP9qnFWn3Ulkq2LJssygbW8G6ZTPHDpO3HC-YauzEOnaJRTuw9B927V4U)
|
|
84
|
-
|
|
85
|
-
<details>
|
|
86
|
-
<summary>Explanation of this</summary>
|
|
87
|
-
|
|
88
|
-
```tsx site/pages/examples/playground.zx
|
|
89
|
-
// A Zig function that returns a `zx.Component`.
|
|
90
|
-
pub fn Playground(allocator: zx.Allocator) zx.Component {
|
|
91
|
-
const is_loading = true;
|
|
92
|
-
var i: usize = 0;
|
|
93
|
-
|
|
94
|
-
// HTML Block is always surrounded by parentheses and can contain HTML elements and control flow statements.
|
|
95
|
-
return (
|
|
96
|
-
// @allocator or any other attribute starting with `@` is called builtin attribute
|
|
97
|
-
// `@allocator` is used to specify the allocator for the component and its children for mem allocation.
|
|
98
|
-
<main @allocator={allocator}>
|
|
99
|
-
<h1>Hello, Ziex!</h1>
|
|
100
|
-
|
|
101
|
-
// `for` loop to iterate over `users` array and render a `Profile` component for each user.
|
|
102
|
-
// Since this is an expression the HTMLs are inside parenteses not curly braces.
|
|
103
|
-
{for (users) |user| (
|
|
104
|
-
// `Profile` component is called with props: name, age, and role.
|
|
105
|
-
// Optional props can be omitted, and the component will receive default values for them.
|
|
106
|
-
<Profile name={user.name} age={user.age} role={user.role} />
|
|
107
|
-
)}
|
|
108
|
-
|
|
109
|
-
// `if` statement works just like other control flow statements.
|
|
110
|
-
{if (is_loading) (<p>Loading...</p>) else (<p>Loaded</p>)}
|
|
111
|
-
|
|
112
|
-
// `while` loop with an optional increment statement.
|
|
113
|
-
{while (i < 5) : (i += 1) (<i>{i}</i>)}
|
|
114
|
-
</main>
|
|
115
|
-
);
|
|
116
|
-
}
|
|
117
|
-
|
|
118
|
-
// A Ziex Component is a Zig function that returns a `zx.Component`.
|
|
119
|
-
// It can have signatures like:
|
|
120
|
-
// - `pub fn ComponentName(allocator: zx.Allocator) zx.Component`
|
|
121
|
-
// - `pub fn ComponentName(ctx: *zx.ComponentCtx<PropsType>) zx.Component`
|
|
122
|
-
// - `pub fn ComponentName(allocator: zx.Allocator, props: PropsType) zx.Component`
|
|
123
|
-
fn Profile(ctx: *zx.ComponentCtx(User)) zx.Component {
|
|
124
|
-
return (
|
|
125
|
-
<div @allocator={ctx.allocator}>
|
|
126
|
-
// Exrepssion starts with `{` and ends with `}`. You can use it to access props, call functions, any valid Zig expression
|
|
127
|
-
<h3>{ctx.props.name}</h3>
|
|
128
|
-
<div>{ctx.props.age}</div>
|
|
129
|
-
<strong>
|
|
130
|
-
{switch (ctx.props.role) {
|
|
131
|
-
.admin => "Admin",
|
|
132
|
-
.member => "Member",
|
|
133
|
-
}}
|
|
134
|
-
</strong>
|
|
135
|
-
</div>
|
|
136
|
-
);
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
const User = struct { name: []const u8, age: u32, role: enum { admin, member } };
|
|
140
|
-
|
|
141
|
-
const users = [_]User{
|
|
142
|
-
.{ .name = "John", .age = 20, .role = .admin },
|
|
143
|
-
.{ .name = "Jane", .age = 21, .role = .member },
|
|
144
|
-
};
|
|
145
|
-
|
|
146
|
-
const zx = @import("zx");
|
|
147
|
-
```
|
|
148
|
-
|
|
149
|
-
</details>
|
|
150
|
-
|
|
151
|
-
## Features
|
|
152
|
-
- **JSX-like Syntax**: Write declarative UI components using familiar JSX patterns, transpiled to efficient Zig code.
|
|
153
|
-
- **Full-Stack Capabilities**: Build both frontend and backend of your web application using
|
|
154
|
-
- **It's Fast**: Significantly faster at SSR than many other frameworks.
|
|
155
|
-
- **Compile-time Safety**: Zig's type system catches bugs at compile time. No runtime surprises, no GC.
|
|
156
|
-
- **Familiar Syntax**: Familiar JSX-like syntax, or plain HTML-style markup, with full access to Zig's control flow.
|
|
157
|
-
- **Server-side Rendering**: Render per request on the server for dynamic data, auth, and personalized pages for best performance and SEO.
|
|
158
|
-
- **Static Site Generation**: Pre-render pages at build/export time into static HTML for fast CDN delivery.
|
|
159
|
-
- **File System Routing**: Folder structure defines routes. No configs, no magic strings, just files in folders.
|
|
160
|
-
- **Client-side Rendering**: Optional client-side rendering for interactive experiences when you need it.
|
|
161
|
-
- **Control Flow in Zig's Syntax**: if/else, for/while, and switch all work as expected. It's just Zig.
|
|
162
|
-
- **Developer Tooling**: CLI, hot reload, and editor extensions for the best DX.
|
|
163
|
-
|
|
164
|
-
## Roadmap
|
|
165
|
-
|
|
166
|
-
We track our feature roadmap and bugs using GitHub Issues.
|
|
167
|
-
You can view our current progress and planned features here:
|
|
168
|
-
|
|
169
|
-
**[Check out the Ziex Issue Tracker →](https://github.com/ziex-dev/ziex/issues)**
|
|
170
|
-
|
|
171
|
-
## Editor Support
|
|
172
|
-
|
|
173
|
-
* [VSCode](https://marketplace.visualstudio.com/items?itemName=ziex.ziex)/[VSCode Forks](https://open-vsx.org/extension/ziex/ziex) Extension
|
|
174
|
-
* [Neovim](/ide/neovim/)
|
|
175
|
-
* [Helix](/ide/helix/)
|
|
176
|
-
* [Zed](/ide/zed/)
|
|
177
|
-
|
|
178
|
-
## Community
|
|
179
|
-
|
|
180
|
-
- [Discord](https://ziex.dev/r/discord)
|
|
181
|
-
- [Topic on Ziggit](https://ziex.dev/r/ziggit)
|
|
182
|
-
- [Project on Zig Discord Community](https://ziex.dev/r/zig-discord) (Join Zig Discord first: https://discord.gg/zig)
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
## Links
|
|
186
|
-
|
|
187
|
-
* [Codeberg Mirror](https://codeberg.org/ziex/ziex) - ZX repository mirror on Codeberg
|
|
188
|
-
* [ziex.dev](https://github.com/ziex-dev/ziex/tree/main/site) - Official documentation site of ZX made using ZX.
|
|
189
|
-
* [example-blog](https://github.com/ziex-dev/example-blog) - Demo blog web application built with ZX
|
|
190
|
-
* [zx-numbers-game](https://github.com/Andrew-Velox/zx-numbers-game) - ZX numbers game
|
|
191
|
-
* [Comparision with other frameworks](https://ziex.dev/vs)
|
|
192
|
-
|
|
193
|
-
## Contributing
|
|
194
|
-
|
|
195
|
-
Contributions are welcome! Currently trying out ZX and reporting issues for edge cases and providing feedback are greatly appreciated.
|
package/app.d.ts
DELETED
|
@@ -1,112 +0,0 @@
|
|
|
1
|
-
import type { DurableObjectNamespace } from "./runtime";
|
|
2
|
-
import type { KVNamespace } from "./kv";
|
|
3
|
-
import type { WASI } from "./wasi";
|
|
4
|
-
/**
|
|
5
|
-
* Anything that can be resolved to a `WebAssembly.Module`:
|
|
6
|
-
* - `WebAssembly.Module` — already compiled (Cloudflare Workers, wrangler)
|
|
7
|
-
* - `ArrayBuffer` / `ArrayBufferView` — raw WASM bytes
|
|
8
|
-
* - `Response` — a fetch() response whose body is the WASM binary
|
|
9
|
-
* - `string` — an HTTP(S) URL or an absolute file path (Bun)
|
|
10
|
-
* - `URL` — a URL object
|
|
11
|
-
*/
|
|
12
|
-
export type WasmInput = WebAssembly.Module | ArrayBuffer | ArrayBufferView | Response | string | URL;
|
|
13
|
-
/**
|
|
14
|
-
* Resolve any supported WASM input to a compiled `WebAssembly.Module`.
|
|
15
|
-
* The result is NOT cached here — cache it at the call site if needed.
|
|
16
|
-
*/
|
|
17
|
-
export declare function resolveModule(input: WasmInput): Promise<WebAssembly.Module>;
|
|
18
|
-
/** Keys of `Env` whose value extends {@link KVNamespace}. */
|
|
19
|
-
type KVKey<Env> = {
|
|
20
|
-
[K in keyof Env]: Env[K] extends KVNamespace ? K : never;
|
|
21
|
-
}[keyof Env];
|
|
22
|
-
/** Keys of `Env` whose value extends {@link DurableObjectNamespace}. */
|
|
23
|
-
type DOKey<Env> = {
|
|
24
|
-
[K in keyof Env]: Env[K] extends DurableObjectNamespace ? K : never;
|
|
25
|
-
}[keyof Env];
|
|
26
|
-
type ZiexOptions<Env> = {
|
|
27
|
-
/** WASM module — accepts any {@link WasmInput}. Resolved and cached on first request. */
|
|
28
|
-
module: WasmInput;
|
|
29
|
-
/** Optional pre-configured WASI instance. */
|
|
30
|
-
wasi?: WASI;
|
|
31
|
-
/** Extra WASM import namespaces. */
|
|
32
|
-
imports?: (mem: () => WebAssembly.Memory) => Record<string, Record<string, unknown>>;
|
|
33
|
-
/**
|
|
34
|
-
* KV namespace bindings. Two forms are supported:
|
|
35
|
-
*
|
|
36
|
-
* - **Env key**: a single key from `Env` whose value is a `KVNamespace` — used as the `"default"` binding.
|
|
37
|
-
* - **Name map**: `{ [bindingName]: envKey }` — map namespace names to env keys.
|
|
38
|
-
*
|
|
39
|
-
* @example Single env key (becomes the "default" binding)
|
|
40
|
-
* ```ts
|
|
41
|
-
* kv: "MY_KV"
|
|
42
|
-
* ```
|
|
43
|
-
* @example Name map
|
|
44
|
-
* ```ts
|
|
45
|
-
* kv: { default: "MY_KV", users: "USERS_KV" }
|
|
46
|
-
* ```
|
|
47
|
-
*/
|
|
48
|
-
kv?: KVKey<Env> | Record<string, KVKey<Env>>;
|
|
49
|
-
/**
|
|
50
|
-
* Env key whose value is a `DurableObjectNamespace` for WebSocket pub/sub.
|
|
51
|
-
* Requires `createWebSocketDO` export on the worker.
|
|
52
|
-
*
|
|
53
|
-
* @example
|
|
54
|
-
* ```ts
|
|
55
|
-
* websocket: "ChatRoom"
|
|
56
|
-
* ```
|
|
57
|
-
*/
|
|
58
|
-
websocket?: DOKey<Env>;
|
|
59
|
-
};
|
|
60
|
-
/**
|
|
61
|
-
* Main Ziex application class. Mirrors the Hono API style — construct once,
|
|
62
|
-
* export as default, and the runtime calls `fetch` for you.
|
|
63
|
-
*
|
|
64
|
-
* Works on Cloudflare Workers, Bun, and Vercel Edge out of the box.
|
|
65
|
-
*
|
|
66
|
-
* @example Cloudflare Workers / wrangler
|
|
67
|
-
* ```ts
|
|
68
|
-
* import { Ziex } from "ziex";
|
|
69
|
-
* import module from "./app.wasm";
|
|
70
|
-
*
|
|
71
|
-
* const app = new Ziex<Env>({
|
|
72
|
-
* module,
|
|
73
|
-
* kv: (env) => ({ default: env.KV }),
|
|
74
|
-
* });
|
|
75
|
-
* export default app;
|
|
76
|
-
* ```
|
|
77
|
-
*
|
|
78
|
-
* @example Bun
|
|
79
|
-
* ```ts
|
|
80
|
-
* import { Ziex } from "ziex";
|
|
81
|
-
* import wasmPath from "./app.wasm" with { type: "wasm" };
|
|
82
|
-
*
|
|
83
|
-
* const app = new Ziex({ module: wasmPath });
|
|
84
|
-
* export default app;
|
|
85
|
-
* ```
|
|
86
|
-
*
|
|
87
|
-
* @example Vercel Edge
|
|
88
|
-
* ```ts
|
|
89
|
-
* import { Ziex } from "ziex";
|
|
90
|
-
* import { handle } from "ziex/vercel";
|
|
91
|
-
*
|
|
92
|
-
* const app = new Ziex({ module: "https://example.com/app.wasm" });
|
|
93
|
-
* export default handle(app);
|
|
94
|
-
* ```
|
|
95
|
-
*/
|
|
96
|
-
export declare class Ziex<Env = Record<string, unknown>> {
|
|
97
|
-
private readonly options;
|
|
98
|
-
private resolved;
|
|
99
|
-
constructor(options: ZiexOptions<Env>);
|
|
100
|
-
private getModule;
|
|
101
|
-
private resolveKV;
|
|
102
|
-
/**
|
|
103
|
-
* Fetch handler called by the runtime on every request.
|
|
104
|
-
*
|
|
105
|
-
* Arrow function so `this` is always the class instance, even when the
|
|
106
|
-
* runtime extracts `fetch` from the exported object (e.g. Bun).
|
|
107
|
-
*/
|
|
108
|
-
fetch: (request: Request, env: Env, ctx?: {
|
|
109
|
-
waitUntil(p: Promise<unknown>): void;
|
|
110
|
-
}) => Promise<Response>;
|
|
111
|
-
}
|
|
112
|
-
export {};
|
package/aws-lambda/index.d.ts
DELETED
|
@@ -1,96 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Ziex adapter for AWS Lambda (API Gateway v1, v2, and ALB).
|
|
3
|
-
*
|
|
4
|
-
* Based on Hono's AWS Lambda adapter implementation.
|
|
5
|
-
*
|
|
6
|
-
* @example API Gateway v2 (HTTP API)
|
|
7
|
-
* ```ts
|
|
8
|
-
* import { Ziex } from "ziex/cloudflare";
|
|
9
|
-
* import { handle } from "ziex/aws-lambda";
|
|
10
|
-
* import module from "./app.wasm";
|
|
11
|
-
*
|
|
12
|
-
* const app = new Ziex({ module });
|
|
13
|
-
* export const handler = handle(app);
|
|
14
|
-
* ```
|
|
15
|
-
*/
|
|
16
|
-
type ApiGwV1Event = {
|
|
17
|
-
version?: "1.0";
|
|
18
|
-
httpMethod: string;
|
|
19
|
-
path: string;
|
|
20
|
-
headers: Record<string, string> | null;
|
|
21
|
-
multiValueHeaders: Record<string, string[]> | null;
|
|
22
|
-
queryStringParameters: Record<string, string> | null;
|
|
23
|
-
multiValueQueryStringParameters: Record<string, string[]> | null;
|
|
24
|
-
body: string | null;
|
|
25
|
-
isBase64Encoded: boolean;
|
|
26
|
-
requestContext: {
|
|
27
|
-
elb?: unknown;
|
|
28
|
-
};
|
|
29
|
-
};
|
|
30
|
-
type ApiGwV2Event = {
|
|
31
|
-
version: "2.0";
|
|
32
|
-
requestContext: {
|
|
33
|
-
http: {
|
|
34
|
-
method: string;
|
|
35
|
-
};
|
|
36
|
-
};
|
|
37
|
-
rawPath: string;
|
|
38
|
-
rawQueryString: string;
|
|
39
|
-
headers: Record<string, string>;
|
|
40
|
-
body?: string;
|
|
41
|
-
isBase64Encoded: boolean;
|
|
42
|
-
};
|
|
43
|
-
type AlbEvent = {
|
|
44
|
-
httpMethod: string;
|
|
45
|
-
path: string;
|
|
46
|
-
headers: Record<string, string> | null;
|
|
47
|
-
multiValueHeaders: Record<string, string[]> | null;
|
|
48
|
-
queryStringParameters: Record<string, string> | null;
|
|
49
|
-
multiValueQueryStringParameters: Record<string, string[]> | null;
|
|
50
|
-
body: string | null;
|
|
51
|
-
isBase64Encoded: boolean;
|
|
52
|
-
requestContext: {
|
|
53
|
-
elb: unknown;
|
|
54
|
-
};
|
|
55
|
-
};
|
|
56
|
-
export type LambdaEvent = ApiGwV1Event | ApiGwV2Event | AlbEvent;
|
|
57
|
-
export type LambdaContext = {
|
|
58
|
-
functionName: string;
|
|
59
|
-
functionVersion: string;
|
|
60
|
-
invokedFunctionArn: string;
|
|
61
|
-
memoryLimitInMB: string;
|
|
62
|
-
awsRequestId: string;
|
|
63
|
-
logGroupName: string;
|
|
64
|
-
logStreamName: string;
|
|
65
|
-
callbackWaitsForEmptyEventLoop: boolean;
|
|
66
|
-
getRemainingTimeInMillis(): number;
|
|
67
|
-
};
|
|
68
|
-
export type LambdaResult = {
|
|
69
|
-
statusCode: number;
|
|
70
|
-
headers: Record<string, string>;
|
|
71
|
-
multiValueHeaders: Record<string, string[]>;
|
|
72
|
-
body: string;
|
|
73
|
-
isBase64Encoded: boolean;
|
|
74
|
-
cookies?: string[];
|
|
75
|
-
};
|
|
76
|
-
type FetchApp = {
|
|
77
|
-
fetch(req: Request, env?: unknown, ctx?: unknown): Promise<Response>;
|
|
78
|
-
};
|
|
79
|
-
export type HandleOptions = {
|
|
80
|
-
/**
|
|
81
|
-
* Content types to encode as base64 in the Lambda response.
|
|
82
|
-
* By default, non-text content types are base64 encoded automatically.
|
|
83
|
-
*/
|
|
84
|
-
binaryMediaTypes?: string[];
|
|
85
|
-
};
|
|
86
|
-
/**
|
|
87
|
-
* Wrap a Ziex app as an AWS Lambda handler.
|
|
88
|
-
*
|
|
89
|
-
* @example
|
|
90
|
-
* ```ts
|
|
91
|
-
* import { handle } from "ziex/aws-lambda";
|
|
92
|
-
* export const handler = handle(app);
|
|
93
|
-
* ```
|
|
94
|
-
*/
|
|
95
|
-
export declare function handle(app: FetchApp, options?: HandleOptions): (event: LambdaEvent, _context?: LambdaContext) => Promise<LambdaResult>;
|
|
96
|
-
export {};
|
package/aws-lambda/index.js
DELETED
|
@@ -1,126 +0,0 @@
|
|
|
1
|
-
var __defProp = Object.defineProperty;
|
|
2
|
-
var __export = (target, all) => {
|
|
3
|
-
for (var name in all)
|
|
4
|
-
__defProp(target, name, {
|
|
5
|
-
get: all[name],
|
|
6
|
-
enumerable: true,
|
|
7
|
-
configurable: true,
|
|
8
|
-
set: (newValue) => all[name] = () => newValue
|
|
9
|
-
});
|
|
10
|
-
};
|
|
11
|
-
|
|
12
|
-
// src/aws-lambda/index.ts
|
|
13
|
-
function isV2(event) {
|
|
14
|
-
return "requestContext" in event && event.requestContext !== null && "http" in event.requestContext;
|
|
15
|
-
}
|
|
16
|
-
function getMethod(event) {
|
|
17
|
-
if (isV2(event))
|
|
18
|
-
return event.requestContext.http.method;
|
|
19
|
-
return event.httpMethod;
|
|
20
|
-
}
|
|
21
|
-
function getPath(event) {
|
|
22
|
-
if (isV2(event)) {
|
|
23
|
-
return event.rawPath + (event.rawQueryString ? `?${event.rawQueryString}` : "");
|
|
24
|
-
}
|
|
25
|
-
const e = event;
|
|
26
|
-
const mvqs = e.multiValueQueryStringParameters;
|
|
27
|
-
const qs = e.queryStringParameters;
|
|
28
|
-
let queryString = "";
|
|
29
|
-
if (mvqs) {
|
|
30
|
-
queryString = Object.entries(mvqs).flatMap(([k, vs]) => (vs ?? []).map((v) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)).join("&");
|
|
31
|
-
} else if (qs) {
|
|
32
|
-
queryString = new URLSearchParams(qs).toString();
|
|
33
|
-
}
|
|
34
|
-
return e.path + (queryString ? `?${queryString}` : "");
|
|
35
|
-
}
|
|
36
|
-
function getHeaders(event) {
|
|
37
|
-
const headers = new Headers;
|
|
38
|
-
if (event.headers) {
|
|
39
|
-
for (const [k, v] of Object.entries(event.headers)) {
|
|
40
|
-
if (v != null)
|
|
41
|
-
headers.set(k, v);
|
|
42
|
-
}
|
|
43
|
-
}
|
|
44
|
-
if ("multiValueHeaders" in event && event.multiValueHeaders) {
|
|
45
|
-
for (const [k, vs] of Object.entries(event.multiValueHeaders)) {
|
|
46
|
-
if (!vs?.length)
|
|
47
|
-
continue;
|
|
48
|
-
headers.delete(k);
|
|
49
|
-
for (const v of vs)
|
|
50
|
-
headers.append(k, v);
|
|
51
|
-
}
|
|
52
|
-
}
|
|
53
|
-
return headers;
|
|
54
|
-
}
|
|
55
|
-
function getBody(event) {
|
|
56
|
-
if (!event.body)
|
|
57
|
-
return null;
|
|
58
|
-
if (event.isBase64Encoded)
|
|
59
|
-
return Buffer.from(event.body, "base64");
|
|
60
|
-
return event.body;
|
|
61
|
-
}
|
|
62
|
-
function toRequest(event, headers) {
|
|
63
|
-
const method = getMethod(event);
|
|
64
|
-
const host = headers.get("host") ?? "localhost";
|
|
65
|
-
const proto = headers.get("x-forwarded-proto") ?? "https";
|
|
66
|
-
const path = getPath(event);
|
|
67
|
-
const url = `${proto}://${host}${path}`;
|
|
68
|
-
const body = ["GET", "HEAD"].includes(method) ? null : getBody(event);
|
|
69
|
-
return new Request(url, { method, headers, body });
|
|
70
|
-
}
|
|
71
|
-
var TEXT_CONTENT_TYPES = [
|
|
72
|
-
"text/",
|
|
73
|
-
"application/json",
|
|
74
|
-
"application/xml",
|
|
75
|
-
"application/javascript",
|
|
76
|
-
"application/xhtml"
|
|
77
|
-
];
|
|
78
|
-
function isBinaryContent(contentType, binaryMediaTypes) {
|
|
79
|
-
if (binaryMediaTypes.length > 0) {
|
|
80
|
-
return binaryMediaTypes.some((t) => contentType.includes(t));
|
|
81
|
-
}
|
|
82
|
-
return !TEXT_CONTENT_TYPES.some((t) => contentType.startsWith(t));
|
|
83
|
-
}
|
|
84
|
-
async function toLambdaResult(res, binaryMediaTypes) {
|
|
85
|
-
const responseHeaders = {};
|
|
86
|
-
const multiValueHeaders = {};
|
|
87
|
-
res.headers.forEach((value, key) => {
|
|
88
|
-
if (key in responseHeaders) {
|
|
89
|
-
multiValueHeaders[key] = [...multiValueHeaders[key] ?? [responseHeaders[key]], value];
|
|
90
|
-
delete responseHeaders[key];
|
|
91
|
-
} else if (key in multiValueHeaders) {
|
|
92
|
-
multiValueHeaders[key].push(value);
|
|
93
|
-
} else {
|
|
94
|
-
responseHeaders[key] = value;
|
|
95
|
-
}
|
|
96
|
-
});
|
|
97
|
-
const contentType = res.headers.get("content-type") ?? "";
|
|
98
|
-
const binary = isBinaryContent(contentType, binaryMediaTypes);
|
|
99
|
-
let body;
|
|
100
|
-
let isBase64Encoded = false;
|
|
101
|
-
if (binary) {
|
|
102
|
-
body = Buffer.from(await res.arrayBuffer()).toString("base64");
|
|
103
|
-
isBase64Encoded = true;
|
|
104
|
-
} else {
|
|
105
|
-
body = await res.text();
|
|
106
|
-
}
|
|
107
|
-
return {
|
|
108
|
-
statusCode: res.status,
|
|
109
|
-
headers: responseHeaders,
|
|
110
|
-
multiValueHeaders,
|
|
111
|
-
body,
|
|
112
|
-
isBase64Encoded
|
|
113
|
-
};
|
|
114
|
-
}
|
|
115
|
-
function handle(app, options = {}) {
|
|
116
|
-
const binaryMediaTypes = options.binaryMediaTypes ?? [];
|
|
117
|
-
return async (event, _context) => {
|
|
118
|
-
const headers = getHeaders(event);
|
|
119
|
-
const req = toRequest(event, headers);
|
|
120
|
-
const res = await app.fetch(req);
|
|
121
|
-
return toLambdaResult(res, binaryMediaTypes);
|
|
122
|
-
};
|
|
123
|
-
}
|
|
124
|
-
export {
|
|
125
|
-
handle
|
|
126
|
-
};
|
package/build.zig
DELETED
package/build.zig.zon
DELETED
package/cloudflare/app.d.ts
DELETED
package/cloudflare/do.d.ts
DELETED
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
import type { WsState } from "../runtime";
|
|
2
|
-
import type { KVNamespace } from "../kv";
|
|
3
|
-
type ConnState = WsState & {
|
|
4
|
-
topics: Set<string>;
|
|
5
|
-
};
|
|
6
|
-
/**
|
|
7
|
-
* Create a Durable Object class that handles WebSocket connections for a ZX app.
|
|
8
|
-
*
|
|
9
|
-
* Each DO instance corresponds to one "room" (keyed by pathname). All clients
|
|
10
|
-
* connecting to the same route share a DO instance, enabling pub/sub via
|
|
11
|
-
* `ctx.socket.subscribe()` / `ctx.socket.publish()`.
|
|
12
|
-
*
|
|
13
|
-
* @example
|
|
14
|
-
* ```ts
|
|
15
|
-
* // worker.ts
|
|
16
|
-
* import { Ziex } from "ziex";
|
|
17
|
-
* import { createWebSocketDO } from "ziex/cloudflare";
|
|
18
|
-
* import module from "./app.wasm";
|
|
19
|
-
*
|
|
20
|
-
* export const ZxWS = createWebSocketDO(module);
|
|
21
|
-
*
|
|
22
|
-
* export default new Ziex({
|
|
23
|
-
* module,
|
|
24
|
-
* websocket: (env) => env.ZxWS,
|
|
25
|
-
* });
|
|
26
|
-
* ```
|
|
27
|
-
*/
|
|
28
|
-
export declare function createWebSocketDO(module: WebAssembly.Module, options?: {
|
|
29
|
-
/**
|
|
30
|
-
* KV namespace bindings for the DO. Pass a factory that receives the DO's
|
|
31
|
-
* `env` so bindings are resolved at runtime:
|
|
32
|
-
*
|
|
33
|
-
* ```ts
|
|
34
|
-
* createWebSocketDO(module, { kv: (env) => ({ default: env.KV }) })
|
|
35
|
-
* ```
|
|
36
|
-
*/
|
|
37
|
-
kv?: (env: any) => Record<string, KVNamespace>;
|
|
38
|
-
imports?: (mem: () => WebAssembly.Memory) => Record<string, Record<string, unknown>>;
|
|
39
|
-
}): {
|
|
40
|
-
new (state: any, env: any): {
|
|
41
|
-
readonly doState: any;
|
|
42
|
-
readonly env: any;
|
|
43
|
-
/** All active connections in this room, keyed by their server-side WebSocket. */
|
|
44
|
-
readonly connections: Map<WebSocket, ConnState>;
|
|
45
|
-
fetch(request: Request): Promise<Response>;
|
|
46
|
-
};
|
|
47
|
-
};
|
|
48
|
-
export {};
|
package/cloudflare/index.d.ts
DELETED