@kubohiroya/turbowarp-http-server 0.2.0 → 0.2.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/README.ja.md +29 -13
- package/README.md +101 -42
- package/dist/cli.js +131 -17
- package/dist/cli.js.map +1 -1
- package/dist/compiler/adapters/cloudflare.d.ts +2 -0
- package/dist/compiler/adapters/cloudflare.js +477 -0
- package/dist/compiler/adapters/cloudflare.js.map +1 -0
- package/dist/compiler/adapters/firebase.d.ts +2 -0
- package/dist/compiler/adapters/firebase.js +489 -0
- package/dist/compiler/adapters/firebase.js.map +1 -0
- package/dist/compiler/adapters/index.d.ts +2 -0
- package/dist/compiler/adapters/index.js +3 -0
- package/dist/compiler/adapters/index.js.map +1 -0
- package/dist/compiler/binary/codec.d.ts +4 -0
- package/dist/compiler/binary/codec.js +45 -0
- package/dist/compiler/binary/codec.js.map +1 -0
- package/dist/compiler/binary/error.d.ts +3 -0
- package/dist/compiler/binary/error.js +21 -0
- package/dist/compiler/binary/error.js.map +1 -0
- package/dist/compiler/binary/index.d.ts +4 -0
- package/dist/compiler/binary/index.js +5 -0
- package/dist/compiler/binary/index.js.map +1 -0
- package/dist/compiler/binary/runtime.d.ts +18 -0
- package/dist/compiler/binary/runtime.js +123 -0
- package/dist/compiler/binary/runtime.js.map +1 -0
- package/dist/compiler/binary/types.d.ts +17 -0
- package/dist/compiler/binary/types.js +2 -0
- package/dist/compiler/binary/types.js.map +1 -0
- package/dist/compiler/feature-flags.d.ts +4 -0
- package/dist/compiler/feature-flags.js +4 -0
- package/dist/compiler/feature-flags.js.map +1 -0
- package/dist/compiler/index.d.ts +35 -0
- package/dist/compiler/index.js +84 -0
- package/dist/compiler/index.js.map +1 -0
- package/dist/compiler/ir-v2/canonical.d.ts +3 -0
- package/dist/compiler/ir-v2/canonical.js +50 -0
- package/dist/compiler/ir-v2/canonical.js.map +1 -0
- package/dist/compiler/ir-v2/index.d.ts +4 -0
- package/dist/compiler/ir-v2/index.js +5 -0
- package/dist/compiler/ir-v2/index.js.map +1 -0
- package/dist/compiler/ir-v2/parse.d.ts +10 -0
- package/dist/compiler/ir-v2/parse.js +753 -0
- package/dist/compiler/ir-v2/parse.js.map +1 -0
- package/dist/compiler/ir-v2/strict-json.d.ts +4 -0
- package/dist/compiler/ir-v2/strict-json.js +133 -0
- package/dist/compiler/ir-v2/strict-json.js.map +1 -0
- package/dist/compiler/ir-v2/types.d.ts +412 -0
- package/dist/compiler/ir-v2/types.js +84 -0
- package/dist/compiler/ir-v2/types.js.map +1 -0
- package/dist/compiler/kvs/lowering.d.ts +13 -0
- package/dist/compiler/kvs/lowering.js +77 -0
- package/dist/compiler/kvs/lowering.js.map +1 -0
- package/dist/compiler/manifest/error.d.ts +7 -0
- package/dist/compiler/manifest/error.js +9 -0
- package/dist/compiler/manifest/error.js.map +1 -0
- package/dist/compiler/manifest/index.d.ts +6 -0
- package/dist/compiler/manifest/index.js +7 -0
- package/dist/compiler/manifest/index.js.map +1 -0
- package/dist/compiler/manifest/operations.d.ts +12 -0
- package/dist/compiler/manifest/operations.js +60 -0
- package/dist/compiler/manifest/operations.js.map +1 -0
- package/dist/compiler/manifest/parse.d.ts +9 -0
- package/dist/compiler/manifest/parse.js +280 -0
- package/dist/compiler/manifest/parse.js.map +1 -0
- package/dist/compiler/manifest/registry.d.ts +3 -0
- package/dist/compiler/manifest/registry.js +48 -0
- package/dist/compiler/manifest/registry.js.map +1 -0
- package/dist/compiler/manifest/resolve.d.ts +14 -0
- package/dist/compiler/manifest/resolve.js +116 -0
- package/dist/compiler/manifest/resolve.js.map +1 -0
- package/dist/compiler/manifest/types.d.ts +95 -0
- package/dist/compiler/manifest/types.js +3 -0
- package/dist/compiler/manifest/types.js.map +1 -0
- package/dist/compiler/named-body/index.d.ts +1 -0
- package/dist/compiler/named-body/index.js +2 -0
- package/dist/compiler/named-body/index.js.map +1 -0
- package/dist/compiler/named-body/lowering.d.ts +18 -0
- package/dist/compiler/named-body/lowering.js +83 -0
- package/dist/compiler/named-body/lowering.js.map +1 -0
- package/dist/compiler/pipeline/compiler.d.ts +18 -0
- package/dist/compiler/pipeline/compiler.js +105 -0
- package/dist/compiler/pipeline/compiler.js.map +1 -0
- package/dist/compiler/pipeline/core-generator.d.ts +3 -0
- package/dist/compiler/pipeline/core-generator.js +483 -0
- package/dist/compiler/pipeline/core-generator.js.map +1 -0
- package/dist/compiler/pipeline/index.d.ts +5 -0
- package/dist/compiler/pipeline/index.js +6 -0
- package/dist/compiler/pipeline/index.js.map +1 -0
- package/dist/compiler/pipeline/registry.d.ts +7 -0
- package/dist/compiler/pipeline/registry.js +17 -0
- package/dist/compiler/pipeline/registry.js.map +1 -0
- package/dist/compiler/pipeline/requirements.d.ts +9 -0
- package/dist/compiler/pipeline/requirements.js +135 -0
- package/dist/compiler/pipeline/requirements.js.map +1 -0
- package/dist/compiler/pipeline/types.d.ts +65 -0
- package/dist/compiler/pipeline/types.js +2 -0
- package/dist/compiler/pipeline/types.js.map +1 -0
- package/dist/compiler/runtime/error.d.ts +6 -0
- package/dist/compiler/runtime/error.js +9 -0
- package/dist/compiler/runtime/error.js.map +1 -0
- package/dist/compiler/runtime/index.d.ts +1 -0
- package/dist/compiler/runtime/index.js +2 -0
- package/dist/compiler/runtime/index.js.map +1 -0
- package/dist/compiler/structured-data/index.d.ts +3 -0
- package/dist/compiler/structured-data/index.js +4 -0
- package/dist/compiler/structured-data/index.js.map +1 -0
- package/dist/compiler/structured-data/lowering.d.ts +30 -0
- package/dist/compiler/structured-data/lowering.js +202 -0
- package/dist/compiler/structured-data/lowering.js.map +1 -0
- package/dist/compiler/structured-data/path.d.ts +2 -0
- package/dist/compiler/structured-data/path.js +60 -0
- package/dist/compiler/structured-data/path.js.map +1 -0
- package/dist/compiler/structured-data/runtime.d.ts +20 -0
- package/dist/compiler/structured-data/runtime.js +210 -0
- package/dist/compiler/structured-data/runtime.js.map +1 -0
- package/dist/compiler/turbowarp-v2.d.ts +8 -0
- package/dist/compiler/turbowarp-v2.js +479 -0
- package/dist/compiler/turbowarp-v2.js.map +1 -0
- package/dist/compiler/validator/index.d.ts +4 -0
- package/dist/compiler/validator/index.js +5 -0
- package/dist/compiler/validator/index.js.map +1 -0
- package/dist/compiler/validator/ir-validator.d.ts +10 -0
- package/dist/compiler/validator/ir-validator.js +463 -0
- package/dist/compiler/validator/ir-validator.js.map +1 -0
- package/dist/compiler/validator/resource-lifetime.d.ts +18 -0
- package/dist/compiler/validator/resource-lifetime.js +106 -0
- package/dist/compiler/validator/resource-lifetime.js.map +1 -0
- package/dist/compiler/validator/turbowarp-subset.d.ts +3 -0
- package/dist/compiler/validator/turbowarp-subset.js +241 -0
- package/dist/compiler/validator/turbowarp-subset.js.map +1 -0
- package/dist/compiler/validator/types.d.ts +30 -0
- package/dist/compiler/validator/types.js +7 -0
- package/dist/compiler/validator/types.js.map +1 -0
- package/dist/config.d.ts +11 -0
- package/dist/config.js +12 -0
- package/dist/config.js.map +1 -0
- package/dist/digest-cli.js +0 -0
- package/dist/extension-manifest.json +102 -0
- package/dist/named-body.d.ts +57 -0
- package/dist/named-body.js +396 -0
- package/dist/named-body.js.map +1 -0
- package/dist/named-data-namespace.d.ts +3 -0
- package/dist/named-data-namespace.js +6 -0
- package/dist/named-data-namespace.js.map +1 -0
- package/dist/protocol.d.ts +13 -1
- package/dist/protocol.js +34 -0
- package/dist/protocol.js.map +1 -1
- package/dist/resource-named-body-provider.d.ts +8 -0
- package/dist/resource-named-body-provider.js +88 -0
- package/dist/resource-named-body-provider.js.map +1 -0
- package/dist/server.d.ts +10 -1
- package/dist/server.js +37 -7
- package/dist/server.js.map +1 -1
- package/dist/turbowarp-http-server.js +516 -1
- package/docs/binary-resource-semantics.ja.md +84 -0
- package/docs/cloudflare-worker-compiler.ja.md +90 -0
- package/docs/compiler-manifest-registry.ja.md +79 -0
- package/docs/compiler-platform-pipeline.ja.md +94 -0
- package/docs/deploy-ir-v2.ja.md +123 -0
- package/docs/fixed-input-editors.ja.md +23 -0
- package/docs/index.html +80 -0
- package/docs/ir-v2-conformance.ja.md +65 -0
- package/docs/named-response-body.ja.md +120 -0
- package/docs/platform-storage-adapters.ja.md +99 -0
- package/docs/server-executable-subset.ja.md +88 -0
- package/docs/structured-data-lowering.ja.md +63 -0
- package/examples/compiler/message-app.v2.ir.json +41 -0
- package/package.json +44 -20
- package/schemas/block-editor-fixed-inputs.schema.json +85 -0
- package/schemas/compiler-extension-manifest.schema.json +126 -0
- package/schemas/compiler-manifest-lock-v1.schema.json +48 -0
- package/schemas/deploy-ir-v2.schema.json +835 -0
- package/schemas/ir-v2-conformance-fixture.schema.json +44 -0
- package/src/block-definitions.json +76 -0
- package/src/cli.ts +136 -23
- package/src/compiler/adapters/cloudflare.ts +510 -0
- package/src/compiler/adapters/firebase.ts +538 -0
- package/src/compiler/adapters/index.ts +2 -0
- package/src/compiler/binary/codec.ts +61 -0
- package/src/compiler/binary/error.ts +25 -0
- package/src/compiler/binary/index.ts +4 -0
- package/src/compiler/binary/runtime.ts +133 -0
- package/src/compiler/binary/types.ts +26 -0
- package/src/compiler/feature-flags.ts +7 -0
- package/src/compiler/index.ts +114 -0
- package/src/compiler/ir-v2/canonical.ts +46 -0
- package/src/compiler/ir-v2/index.ts +9 -0
- package/src/compiler/ir-v2/parse.ts +921 -0
- package/src/compiler/ir-v2/strict-json.ts +129 -0
- package/src/compiler/ir-v2/types.ts +462 -0
- package/src/compiler/kvs/lowering.ts +88 -0
- package/src/compiler/manifest/error.ts +29 -0
- package/src/compiler/manifest/index.ts +17 -0
- package/src/compiler/manifest/operations.ts +175 -0
- package/src/compiler/manifest/parse.ts +390 -0
- package/src/compiler/manifest/registry.ts +74 -0
- package/src/compiler/manifest/resolve.ts +159 -0
- package/src/compiler/manifest/types.ts +112 -0
- package/src/compiler/named-body/index.ts +1 -0
- package/src/compiler/named-body/lowering.ts +186 -0
- package/src/compiler/pipeline/compiler.ts +138 -0
- package/src/compiler/pipeline/core-generator.ts +486 -0
- package/src/compiler/pipeline/index.ts +5 -0
- package/src/compiler/pipeline/registry.ts +18 -0
- package/src/compiler/pipeline/requirements.ts +139 -0
- package/src/compiler/pipeline/types.ts +59 -0
- package/src/compiler/runtime/error.ts +11 -0
- package/src/compiler/runtime/index.ts +1 -0
- package/src/compiler/structured-data/index.ts +3 -0
- package/src/compiler/structured-data/lowering.ts +314 -0
- package/src/compiler/structured-data/path.ts +53 -0
- package/src/compiler/structured-data/runtime.ts +221 -0
- package/src/compiler/turbowarp-v2.ts +610 -0
- package/src/compiler/validator/index.ts +4 -0
- package/src/compiler/validator/ir-validator.ts +812 -0
- package/src/compiler/validator/resource-lifetime.ts +153 -0
- package/src/compiler/validator/turbowarp-subset.ts +387 -0
- package/src/compiler/validator/types.ts +68 -0
- package/src/extension.ts +87 -1
- package/src/fixed-input-editors.ts +181 -0
- package/src/fixed-input-schema.ts +15 -0
- package/src/named-body.ts +495 -0
- package/src/named-data-namespace.ts +6 -0
- package/src/protocol.ts +50 -1
- package/src/resource-named-body-provider.ts +106 -0
- package/src/server.ts +88 -8
- package/docs/turbowarp-http-server.architecture.visual-check.1440x900.dark.png +0 -0
- package/docs/turbowarp-http-server.architecture.visual-check.1440x900.light.png +0 -0
- package/docs/turbowarp-http-server.architecture.visual-check.2048x1320.dark.png +0 -0
- package/docs/turbowarp-http-server.architecture.visual-check.2048x1320.light.png +0 -0
- package/docs/turbowarp-http-server.architecture.visual-check.html +0 -32
- package/docs/turbowarp-http-server.architecture.visual-check.json +0 -547
- package/schemas/extension-manifest.schema.json +0 -49
- package/src/extension-manifest.ts +0 -149
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# TurboWarp → Cloudflare Workers/Hono コンパイラ設計
|
|
2
|
+
|
|
3
|
+
Issue #13のMVPとして、TurboWarpのHTTP handlerまたはDeploy IR v2から、Cloudflare Workers上で動作するHono applicationを生成する。compilerはIR v2だけを受理し、targetとして`cloudflare-workers`を明示する。旧IR v1とそのupgraderは提供しない。
|
|
4
|
+
|
|
5
|
+
既存のWebSocket bridgeは独立した実行経路であり、`compile` subcommandを実行しない限り生成処理は行わない。
|
|
6
|
+
|
|
7
|
+
## アーキテクチャ
|
|
8
|
+
|
|
9
|
+
```text
|
|
10
|
+
TurboWarp project.json ─ manifest-aware frontend ─┐
|
|
11
|
+
├─ Deploy IR v2
|
|
12
|
+
Deploy IR v2 JSON ─────── strict parser ──────────┘
|
|
13
|
+
-> server-safe validator
|
|
14
|
+
-> capability extraction
|
|
15
|
+
-> platform-neutral Hono core
|
|
16
|
+
-> Cloudflare adapter
|
|
17
|
+
-> deterministic filesystem artifacts
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
IRの型とserializationは[Deploy IR v2 基礎仕様](deploy-ir-v2.ja.md)、許可blockは[Server-executable subset](server-executable-subset.ja.md)、target境界は[Compiler/Platform pipeline](compiler-platform-pipeline.ja.md)を正本とする。
|
|
21
|
+
|
|
22
|
+
## CLI
|
|
23
|
+
|
|
24
|
+
```sh
|
|
25
|
+
# TurboWarp project.json
|
|
26
|
+
turbowarp-http-server compile \
|
|
27
|
+
--input ./project.json \
|
|
28
|
+
--output ./generated-worker \
|
|
29
|
+
--format turbowarp-json \
|
|
30
|
+
--target cloudflare-workers \
|
|
31
|
+
--manifest-lock ./turbowarp-server.lock.json
|
|
32
|
+
|
|
33
|
+
# Deploy IR v2 JSON
|
|
34
|
+
turbowarp-http-server compile \
|
|
35
|
+
--input ./examples/compiler/message-app.v2.ir.json \
|
|
36
|
+
--output ./generated-worker \
|
|
37
|
+
--format ir \
|
|
38
|
+
--target cloudflare-workers
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
`--target`は必須であり、compilerはplatformを推測しない。`.sb3`の直接入力は対象外なので、TurboWarpから`project.json`を取り出して入力する。出力先が空でない場合は失敗し、置換する場合だけ`--force`を明示する。
|
|
42
|
+
|
|
43
|
+
## 生成物
|
|
44
|
+
|
|
45
|
+
IRのcapabilityに応じて次のfileを生成する。
|
|
46
|
+
|
|
47
|
+
```text
|
|
48
|
+
generated-worker/
|
|
49
|
+
src/core.generated.ts
|
|
50
|
+
src/index.ts
|
|
51
|
+
src/platform.ts
|
|
52
|
+
migrations/0001_init.sql # record-storeまたはkey-value-store利用時
|
|
53
|
+
package.json
|
|
54
|
+
tsconfig.json
|
|
55
|
+
wrangler.jsonc
|
|
56
|
+
README.md
|
|
57
|
+
turbowarp-server.generated.json
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
`core.generated.ts`はCloudflare SDKをimportしない。`index.ts`と`platform.ts`がD1/R2 bindingをHono coreのservice interfaceへ接続する。出力manifestにはadapter ID/version、capability plan、binding、生成file一覧を記録する。
|
|
61
|
+
|
|
62
|
+
## HTTP、state、storage
|
|
63
|
+
|
|
64
|
+
- request method、path、query、header、bodyは型付きIR expressionへ変換する。
|
|
65
|
+
- status/header操作の後、すべてのcontrol-flow pathをちょうど一つのterminal responseで終了する。
|
|
66
|
+
- handler variableはrequest-localであり、request終了時に破棄する。
|
|
67
|
+
- Scratch variable/list、broadcast、`forever`、暗黙の並行scriptは拒否する。
|
|
68
|
+
- `record-store`と`key-value-store`はCloudflare adapterでD1へ写像する。
|
|
69
|
+
- `object-storage`とstreaming binary bodyはR2へ写像する。
|
|
70
|
+
- 正確なcounterやroom state向けDurable ObjectsはMVP対象外である。
|
|
71
|
+
|
|
72
|
+
Asset Manager/Asset Cacheのbrowser blockをR2操作へ読み替えない。Asset Cacheはbrowser内の登録・cache・再生を担当し、server compilerではbrowser-only opcodeとして拒否する。portableなnamespace/key操作は`turbowarp-kvs` manifest、binary bodyは独立したIR v2 resource contractを正本とする。
|
|
73
|
+
|
|
74
|
+
## 認証と安全性
|
|
75
|
+
|
|
76
|
+
IR v2の認証はplatform-neutralなJWT capabilityとして表現する。Cloudflare adapterが未対応の認証capabilityを宣言した場合は、類似実装へfallbackせずcompile errorにする。OAuth/OIDC provider、login/callback、token発行は生成しない。
|
|
77
|
+
|
|
78
|
+
生成コードでは次を禁止する。
|
|
79
|
+
|
|
80
|
+
- Node.js専用の`fs`、`net`、`http`、`process`をWorker処理へ持ち込むこと
|
|
81
|
+
- module/global変数を永続stateとして使うこと
|
|
82
|
+
- unsafe header、CR/LF injection、runtime所有headerの上書き
|
|
83
|
+
- secret、credential、project IDをIR、target config、生成sourceへ直書きすること
|
|
84
|
+
- request body、binary payload、logical locator、platform SDK errorをdiagnosticへ出すこと
|
|
85
|
+
|
|
86
|
+
secretはWrangler secretまたはCloudflare dashboardから設定する。compilerとadapterはnetwork deploy、credential操作、cloud resource作成を行わない。
|
|
87
|
+
|
|
88
|
+
## ロールバック
|
|
89
|
+
|
|
90
|
+
問題時は生成物のdeployを停止し、既存のWebSocket bridgeを使用する。既存cloud resourceは自動削除しない。必要なD1/R2 dataをexportし、依存deploymentとbindingを確認した後、generated READMEに従って利用者が明示的にcleanupする。
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# Compiler extension manifest registry
|
|
2
|
+
|
|
3
|
+
Deploy IR v2 frontendは、外部TurboWarp extensionのopcodeをcompiler内の手書き定義だけから推測しません。明示された`turboWarp-server.lock.json`、lockが指すmanifestのexact bytes、compiler側allowlistの3つが一致した場合だけopcode registryへ登録します。
|
|
4
|
+
|
|
5
|
+
manifest registryはTurboWarp projectをIR v2へ変換する唯一の外部extension解決経路です。
|
|
6
|
+
|
|
7
|
+
## 対応形式
|
|
8
|
+
|
|
9
|
+
- compiler manifest format 1: extension ID、block type、argument ID/typeだけを提供するlegacy block API manifest。
|
|
10
|
+
- compiler manifest format 2: format 1にresult type、effect、immutable、runtime error、server-operation hintを加えた形式。Asset Cache 0.1.0のbrowser-only宣言、Structured Data 0.4.0、KVS 0.1.0のfixtureとの互換性を確認します。
|
|
11
|
+
- lock format 1: extension ID、exact package version、manifest format version、exact-byte SHA-256、sourceを固定します。
|
|
12
|
+
|
|
13
|
+
machine-readable schemaは次のとおりです。
|
|
14
|
+
|
|
15
|
+
- [`schemas/compiler-extension-manifest.schema.json`](../schemas/compiler-extension-manifest.schema.json)
|
|
16
|
+
- [`schemas/compiler-manifest-lock-v1.schema.json`](../schemas/compiler-manifest-lock-v1.schema.json)
|
|
17
|
+
|
|
18
|
+
format 1 manifestはregistryへ読めますが、server-operation hintがないblockを自動的にserver対応とは判断しません。Asset Cache blockをKVSやobject storageへ推測変換しません。KVSはformat 2の明示的な`kvs.*` operationだけをloweringします。
|
|
19
|
+
|
|
20
|
+
## Lock
|
|
21
|
+
|
|
22
|
+
```json
|
|
23
|
+
{
|
|
24
|
+
"lockVersion": 1,
|
|
25
|
+
"extensions": [
|
|
26
|
+
{
|
|
27
|
+
"extensionId": "kubohiroyastructureddata",
|
|
28
|
+
"packageName": "@kubohiroya/turbowarp-structured-data",
|
|
29
|
+
"packageVersion": "0.4.0",
|
|
30
|
+
"manifestFormatVersion": 2,
|
|
31
|
+
"integrity": "sha256-<base64 SHA-256>",
|
|
32
|
+
"source": {"kind": "local", "path": "manifests/structured-data.json"}
|
|
33
|
+
}
|
|
34
|
+
]
|
|
35
|
+
}
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
`packageVersion`はexact versionだけを受理し、range、tag、`latest`を解決しません。integrityはmanifest fileのexact bytesに対するSHA-256です。JSONの再整形やcanonicalization後のhashではありません。
|
|
39
|
+
|
|
40
|
+
sourceは次の2種類だけです。
|
|
41
|
+
|
|
42
|
+
- `bundled`: compiler callerがIDとexact bytesを登録したmanifest
|
|
43
|
+
- `local`: lock fileのdirectoryを基準とする相対path
|
|
44
|
+
|
|
45
|
+
URL、npm registry、cwd探索、暗黙downloadはありません。resolver順は常に「lock entry → entryが指すbundled/local source」です。
|
|
46
|
+
|
|
47
|
+
CLIではTurboWarp project入力に限り`--manifest-lock <file>`でlockを指定します。このoptionは`--format turbowarp-json`と組み合わせ、direct IR入力では受理しません。
|
|
48
|
+
|
|
49
|
+
local sourceはabsolute path、lock directory外への`..`、symlink componentを拒否します。realpath後にもlock directory内であることを再確認します。
|
|
50
|
+
|
|
51
|
+
## Registryとoperation hint
|
|
52
|
+
|
|
53
|
+
project opcodeは`<extensionId>_<opcode>`で一意に解決します。lockにないextension/opcodeは`TW2_MANIFEST_UNKNOWN_OPCODE`です。package versionをopcode prefixから推測しません。
|
|
54
|
+
|
|
55
|
+
`server.irOperation`は実装ruleではなくhintです。`server.supported: true`の場合、operation ID、opcode、block type、argument順・型・制約、result type、effect、immutableがcompilerの`KNOWN_SERVER_OPERATIONS`と完全一致しなければ`TW2_MANIFEST_OPERATION_MISMATCH`になります。manifestからJavaScript、module path、template、code snippetを読み込んだり実行したりしません。
|
|
56
|
+
|
|
57
|
+
## 入力制限
|
|
58
|
+
|
|
59
|
+
既定値はtargetによらず固定です。
|
|
60
|
+
|
|
61
|
+
- manifest/lock: 最大1 MiB
|
|
62
|
+
- JSON nesting: 最大64
|
|
63
|
+
- blocks: 最大2048
|
|
64
|
+
- duplicate JSON key: 拒否
|
|
65
|
+
- duplicate extension ID、opcode、argument ID、error code: 拒否
|
|
66
|
+
- unknown field/version/enum: 拒否
|
|
67
|
+
- UTF-8不正: 拒否
|
|
68
|
+
|
|
69
|
+
失敗は`CompilerManifestError`と安定した`TW2_MANIFEST_*` codeで返します。runtime error codeとは別namespaceです。
|
|
70
|
+
|
|
71
|
+
## Lowering境界
|
|
72
|
+
|
|
73
|
+
1. frontendはprojectで使われるnon-core extensionにlock entryを要求します。
|
|
74
|
+
2. registryでblock signatureとoperation hintを検証してから、既知loweringへ渡します。
|
|
75
|
+
3. manifest version不一致時に旧定義や類似operationへfallbackしません。
|
|
76
|
+
|
|
77
|
+
## ロールバック
|
|
78
|
+
|
|
79
|
+
問題時は該当manifest lockを使う生成を停止します。lockは診断・再現用artifactとして保持し、compilerは外部packageやcloud resourceを変更しません。
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
# IR v2 compiler/platform adapter境界
|
|
2
|
+
|
|
3
|
+
Deploy IR v2の生成pipelineは、target-neutralな検証とHono core生成を、platform固有の計画・entrypoint・storage・deploy artifact生成から分離します。compilerはIR v2だけを扱い、CLIではtargetを必ず明示します。
|
|
4
|
+
|
|
5
|
+
```text
|
|
6
|
+
Deploy IR v2
|
|
7
|
+
-> target-neutral validator
|
|
8
|
+
-> capability requirement extraction
|
|
9
|
+
-> PlatformAdapter registry / plan
|
|
10
|
+
-> platform-neutral Hono core generator
|
|
11
|
+
-> adapter artifact generator
|
|
12
|
+
-> deterministic generated project + output manifest
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## CLI contract
|
|
16
|
+
|
|
17
|
+
v2 direct IRは次のようにcompileします。
|
|
18
|
+
|
|
19
|
+
```sh
|
|
20
|
+
turbowarp-http-server compile \
|
|
21
|
+
--input deploy-ir-v2.json \
|
|
22
|
+
--output generated-worker \
|
|
23
|
+
--format ir \
|
|
24
|
+
--target cloudflare-workers
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
同じIRをFirebase Functionsへ生成する場合は`--target firebase-functions`へ切り替えます。target固有のbinding/環境変数名は`--target-config`で指定し、IRは変更しません。
|
|
28
|
+
|
|
29
|
+
TurboWarp `project.json`と外部extensionをcompileする場合は、検証済みmanifest lockを明示します。
|
|
30
|
+
|
|
31
|
+
```sh
|
|
32
|
+
turbowarp-http-server compile \
|
|
33
|
+
--input project.json \
|
|
34
|
+
--output generated-worker \
|
|
35
|
+
--format turbowarp-json \
|
|
36
|
+
--target cloudflare-workers \
|
|
37
|
+
--manifest-lock turboWarp-server.lock.json
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
- `--target`を必須とし、targetを推測しません。
|
|
41
|
+
- CLI入力はcanonical `--format ir`に加え、built-in HTTP block subsetの`--format turbowarp-json`を受理します。
|
|
42
|
+
- `--target-config <file>`はadapter設定です。IRへmergeせず、secret値を受け取りません。
|
|
43
|
+
- `--enable-named-response-body`は実験的な`respond-named-body`だけを有効化し、既定OFFです。選択targetに`named-body-provider`がなければ生成しません。
|
|
44
|
+
- `--format turbowarp-json`はbuilt-in HTTP block、literal bounded repeat、named responseを直接IR v2へloweringします。`--manifest-lock`指定時はlock済みStructured Data reporter/loopとKVS 0.1.0の5操作も同じfrontendでloweringします。lockにないextension opcodeやAsset Cacheのbrowser-only操作を推測しません。
|
|
45
|
+
- Cloudflare adapterはD1/R2 binding名、Firebase adapterはfunction名/bucket環境変数名/Firestore collection名だけを受け取ります。secretやproject IDは受け取りません。詳細は[IR v2 platform storage adapter](platform-storage-adapters.ja.md)を参照してください。
|
|
46
|
+
|
|
47
|
+
## module責務
|
|
48
|
+
|
|
49
|
+
| phase | module | 責務 |
|
|
50
|
+
| --- | --- | --- |
|
|
51
|
+
| parse | `compiler/ir-v2` | strict JSON/schemaから型付きIRを作る |
|
|
52
|
+
| validate | `compiler/validator` | targetに依存しない型、control flow、resource lifetimeを検証する |
|
|
53
|
+
| requirements | `compiler/pipeline/requirements` | 宣言capabilityを正規化し、要求元route/`sourceRef`を特定する |
|
|
54
|
+
| registry/plan | `compiler/pipeline` | targetを解決し、adapter capabilityと設定を検証する |
|
|
55
|
+
| core generator | `compiler/pipeline/core-generator` | Hono routeと抽象service境界を生成する |
|
|
56
|
+
| adapter | `compiler/adapters` | platform entrypoint、binding、storage、deploy設定を生成する |
|
|
57
|
+
|
|
58
|
+
`PlatformAdapter.plan`と`generate`はnetwork、deploy、cloud resource作成を行わないpure filesystem artifact operationです。新しいadapterはregistryへ追加でき、frontendやopcode loweringを変更する必要はありません。
|
|
59
|
+
|
|
60
|
+
共有coreはCloudflare、Firebase、D1、R2等の製品型を参照しません。たとえばclient addressは`CoreServices.clientAddress`、KVSは`CoreServices.keyValues`、record永続化は`CoreServices.records`、binary objectは`CoreServices.objects`を介し、選択adapterがplatform APIへ結び付けます。
|
|
61
|
+
|
|
62
|
+
## diagnostic
|
|
63
|
+
|
|
64
|
+
- 未登録target: `TW2_UNKNOWN_TARGET`
|
|
65
|
+
- target capability不足: `TW2_TARGET_CAPABILITY_UNSUPPORTED`
|
|
66
|
+
- adapter設定不正: `TW2_TARGET_CONFIG_INVALID`
|
|
67
|
+
|
|
68
|
+
capability不足にはtarget ID、要求元route ID、取得可能な場合はTurboWarp blockの`sourceRef`、理由、代替案を含めます。target-neutral validationが失敗した場合はadapter planへ進まず、部分的な生成物も書きません。
|
|
69
|
+
|
|
70
|
+
## runtime error boundary
|
|
71
|
+
|
|
72
|
+
terminal response開始前の既知runtime faultは次のenvelopeへ変換します。
|
|
73
|
+
|
|
74
|
+
```json
|
|
75
|
+
{"error":{"code":"STABLE_CODE"}}
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
Structured Dataのstatus mappingは[Structured Data lowering](structured-data-lowering.ja.md)、binaryは[Binary resource semantics](binary-resource-semantics.ja.md)を正本とします。KVSの不正namespace/keyは422、storage failureは502です。未知の例外または未知codeは500 `IR_RUNTIME_ERROR`です。message、stack、request body、binary、locator、secret、platform SDK errorはresponseへ含めません。
|
|
79
|
+
|
|
80
|
+
## deterministic output manifest
|
|
81
|
+
|
|
82
|
+
生成fileはpath昇順、UTF-8、LF、末尾newlineありで正規化します。timestamp、random ID、absolute pathは生成物へ埋め込みません。`turbowarp-server.generated.json`は次を記録します。
|
|
83
|
+
|
|
84
|
+
- manifest format version
|
|
85
|
+
- Deploy IR version
|
|
86
|
+
- target adapter ID/version
|
|
87
|
+
- capability plan
|
|
88
|
+
- 生成file一覧
|
|
89
|
+
|
|
90
|
+
同じIR、target、adapter version、target configからはbyte-for-byte同じ生成物を得ます。
|
|
91
|
+
|
|
92
|
+
## ロールバック
|
|
93
|
+
|
|
94
|
+
問題時は対象targetへの生成・deployを停止し、既存のbrowser bridgeを利用します。生成処理はcloud resourceを変更しないため、rollback時にresource削除は行いません。
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
# Deploy IR v2 基礎仕様
|
|
2
|
+
|
|
3
|
+
Deploy IR v2は、TurboWarpのHTTP handlerをplatform-neutralな型付き表現へ変換する中間表現です。compilerが受理するIR versionはv2だけです。
|
|
4
|
+
|
|
5
|
+
型、strict parser、JSON Schema、canonical serializerに加え、明示的なtargetを選択するCLI pipelineを提供します。[Compiler/platform adapter境界](compiler-platform-pipeline.ja.md)を参照してください。
|
|
6
|
+
|
|
7
|
+
外部extension manifestのlock/offline解決仕様は[Compiler extension manifest registry](compiler-manifest-registry.ja.md)を参照してください。
|
|
8
|
+
|
|
9
|
+
許可block、binding scope、bounded control flow、response、work budgetの規則は[Server-executable subset](server-executable-subset.ja.md)を参照してください。
|
|
10
|
+
|
|
11
|
+
Structured Data blockの変換規則は[Structured Data lowering](structured-data-lowering.ja.md)を参照してください。
|
|
12
|
+
|
|
13
|
+
binary resourceの所有権、上限、storage contractは[Binary resource semantics](binary-resource-semantics.ja.md)を参照してください。
|
|
14
|
+
|
|
15
|
+
Cloudflare/Firebaseのstorage mappingとtarget設定は[IR v2 platform storage adapter](platform-storage-adapters.ja.md)を参照してください。
|
|
16
|
+
|
|
17
|
+
layer横断のgolden/trace検証は[IR v2 semantic conformance harness](ir-v2-conformance.ja.md)を参照してください。
|
|
18
|
+
|
|
19
|
+
Structured/document/binaryを共通HTTP bodyとして返すprovider contractと`respond-named-body` statementは[Named response body provider contract](named-response-body.ja.md)を参照してください。実provider adapterは後続実装です。
|
|
20
|
+
|
|
21
|
+
## Versionと有効化
|
|
22
|
+
|
|
23
|
+
- rootの`version`は整数`2`です。
|
|
24
|
+
- manifest schema version、extension package version、adapter versionとは独立しています。
|
|
25
|
+
- CLIでは`--target`を必須とし、targetを暗黙選択しません。
|
|
26
|
+
- rootのversionが2以外なら`TW2_IR_VERSION`で拒否します。
|
|
27
|
+
|
|
28
|
+
## 型
|
|
29
|
+
|
|
30
|
+
IR JSONへ格納できるatomic value typeは次のとおりです。
|
|
31
|
+
|
|
32
|
+
- `null`
|
|
33
|
+
- `boolean`
|
|
34
|
+
- `number`
|
|
35
|
+
- `string`
|
|
36
|
+
- `json-text`
|
|
37
|
+
- `json-array`
|
|
38
|
+
- `json-object`
|
|
39
|
+
- `binary-ref`
|
|
40
|
+
|
|
41
|
+
`number`は有限IEEE-754 binary64とし、`NaN`と±`Infinity`を拒否します。`-0`は`0`へ正規化します。`json-text`は有効なapplication JSONを表すnominal string境界で、通常の`string`やparse済みJSON値とは暗黙に混同しません。`json-array`と`json-object`は再帰的なJSON値で、resourceを内包できません。
|
|
42
|
+
|
|
43
|
+
`binary-ref`はbyte列ではなく、`namespace`と`key`、任意の`contentType`、`size`、`sha256:<hex>`形式の`integrity`、opaque `revision`を持つ論理descriptorです。`base64`、`bytes`、data URL等のinline payload fieldは許可しません。
|
|
44
|
+
|
|
45
|
+
`binary-body`はvalueではありません。stream本体をIR JSONへ格納せず、`resource` bindingのIDとしてだけ表現します。この区別により、後続validatorがclone、二重consume、scope外利用を検出できます。
|
|
46
|
+
|
|
47
|
+
union typeは次の形式です。
|
|
48
|
+
|
|
49
|
+
```json
|
|
50
|
+
{"kind":"union","members":["null","json-object"]}
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## Expressionとstatement
|
|
54
|
+
|
|
55
|
+
すべてのexpressionは`valueType`を持ちます。v2で定義済みのexpressionはliteral、request、request-value、concat、handler-variable、handler-variable-exists、handler-variable-names、bindingに加え、KVS get/has/list、明示的なJSON parse/serialize、path操作、iteration reporterです。
|
|
56
|
+
|
|
57
|
+
statementはHTTP response操作、handler-variable操作、KVS set/delete、論理record/object storage操作、binary body producer/consumer、typed `if`、bounded-loop、`json-for-each`、terminal responseを表現します。一般的なScratch control blockを受理するかどうかはschemaではなくfrontend/validatorの責務です。
|
|
58
|
+
|
|
59
|
+
statementのeffectは入力側が自由に申告するfieldにはせず、statement kindから`IR_V2_STATEMENT_EFFECTS`で決定的に導出します。分類は`response-write`、`handler-state-write`、`key-value-read`、`key-value-write`、`record-read`、`record-write`、`control`等です。これにより入力がeffectを過少申告してvalidatorを迂回することを防ぎます。
|
|
60
|
+
|
|
61
|
+
JSON pathは`PathSegmentV2`とschemaの`pathSegment`で、string keyと非負整数indexを別のvariantとして定義します。`json-for-each`はlexical `loopId`を作り、そのbody内だけでiteration key/index/value reporterから参照できます。
|
|
62
|
+
|
|
63
|
+
`sourceRef`はtarget index/name、block ID、opcode、任意のinput名を保持します。diagnostic用であり、生成コードの意味には影響しません。direct IRでは省略できます。
|
|
64
|
+
|
|
65
|
+
## Strict parsing
|
|
66
|
+
|
|
67
|
+
`parseDeployIrV2Json`はJSON textを読み、次を拒否します。
|
|
68
|
+
|
|
69
|
+
- duplicate object key
|
|
70
|
+
- unknown field
|
|
71
|
+
- unknown node kind
|
|
72
|
+
- 型とliteral値の不一致
|
|
73
|
+
- 非有限number
|
|
74
|
+
- 不正なbinding ID
|
|
75
|
+
- 不正なsourceRef
|
|
76
|
+
|
|
77
|
+
失敗時は`DeployIrV2ParseError`を送出し、呼び出し側が文面を解析せず扱える安定したcodeを持たせます。
|
|
78
|
+
|
|
79
|
+
- `TW2_IR_JSON_SYNTAX`: JSON構文エラー
|
|
80
|
+
- `TW2_IR_DUPLICATE_KEY`: duplicate object key
|
|
81
|
+
- `TW2_IR_VERSION`: 未対応IR version
|
|
82
|
+
- `TW2_IR_UNKNOWN_FIELD`: unknown field
|
|
83
|
+
- `TW2_IR_UNKNOWN_NODE`: unknown expression/statement等のnode kind
|
|
84
|
+
- `TW2_IR_INVALID_VALUE`: その他のschema/値制約違反
|
|
85
|
+
|
|
86
|
+
既知objectには`additionalProperties: false`を適用します。未知fieldを無視して将来の意味へ誤変換しません。
|
|
87
|
+
|
|
88
|
+
machine-readable schemaは[`schemas/deploy-ir-v2.schema.json`](../schemas/deploy-ir-v2.schema.json)です。runtime parserはschema validatorの有無に依存せず、同じnode集合を検証します。
|
|
89
|
+
|
|
90
|
+
## Canonical serialization
|
|
91
|
+
|
|
92
|
+
IR documentのhashとgolden比較にはRFC 8785(JCS)形式を使用します。object keyはUTF-16 code unit順、array順は保持、whitespaceは挿入しません。lone surrogateを含む不正なUnicode stringはcanonicalizeせず拒否します。
|
|
93
|
+
|
|
94
|
+
これはStructured Data extensionが扱うapplication JSONの正規化規則とは別です。application JSONをIR document用JCSへ暗黙変換しません。
|
|
95
|
+
|
|
96
|
+
## Capability
|
|
97
|
+
|
|
98
|
+
IR coreは製品名ではなく、次のような論理requirementを持ちます。
|
|
99
|
+
|
|
100
|
+
- `record-store`
|
|
101
|
+
- `key-value-store`
|
|
102
|
+
- `object-storage`
|
|
103
|
+
- `streaming-body`
|
|
104
|
+
- `named-body-provider`
|
|
105
|
+
- `request-metadata: client-address`
|
|
106
|
+
- `auth: external-jwt | trusted-access-jwt`
|
|
107
|
+
|
|
108
|
+
D1、Cloudflare KV、R2、Firestore、Cloud Storage等の選択はIRへ書かず、後続のPlatformAdapterが行います。現行`key-value-store`はread-after-writeを要求するため、Cloudflare adapterはD1へ写像します。
|
|
109
|
+
|
|
110
|
+
capabilityとunion typeのmemberはsetとして扱い、parserが重複を拒否して決定的な順序へ正規化します。routeとstatementの配列順は実行順なので保持します。
|
|
111
|
+
|
|
112
|
+
## ファイル
|
|
113
|
+
|
|
114
|
+
- `src/compiler/ir-v2/types.ts`: TypeScript型
|
|
115
|
+
- `src/compiler/ir-v2/parse.ts`: strict object parser
|
|
116
|
+
- `src/compiler/ir-v2/strict-json.ts`: duplicate-keyを拒否するJSON text parser
|
|
117
|
+
- `src/compiler/ir-v2/canonical.ts`: canonical serializer
|
|
118
|
+
- `schemas/deploy-ir-v2.schema.json`: JSON Schema
|
|
119
|
+
- `examples/compiler/message-app.v2.ir.json`: v2 example
|
|
120
|
+
|
|
121
|
+
## ロールバック
|
|
122
|
+
|
|
123
|
+
問題時は生成・deployを停止し、既存のbrowser bridgeを利用します。compilerはcloud resourceを変更しないため、自動削除は行いません。
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# 固定入力の編集
|
|
2
|
+
|
|
3
|
+
S3-4のローカル実装です。対応GUIの固定入力機能は既定OFFです。旧GUI・API無し・固定入力機能OFFではブロックの従来動作を保ちます。`getInfo()` に存在する対象opcodeだけ登録し、再取得・APIの置換・拡張の`dispose()`・runtimeの破棄に対応します。既存SOURCEエディターとopcodeは分離しています。
|
|
4
|
+
|
|
5
|
+
|ブロックopcode|引数|UI|
|
|
6
|
+
|---|---|---|
|
|
7
|
+
|`changeHandlerVariable`|`AMOUNT`|数値入力(NP)|
|
|
8
|
+
|`setHttpStatus`|`STATUS`|数値入力(NP)|
|
|
9
|
+
|`respondWithNamedBody`|`KIND`|既定値からの選択:`structured`, `document`, `binary`, `asset`|
|
|
10
|
+
|`respondWithNamedBody`|`SCOPE`|既定値からの選択:`target`, `project`|
|
|
11
|
+
|`respondWithNamedBody`|`REPRESENTATION`|既定値からの選択:`json`, `yaml`, `html`, `markdown`, `raw`|
|
|
12
|
+
|`respondWithNamedBody`|`MAX_BYTES`|数値入力(NP)|
|
|
13
|
+
|`markdownHeading`|`LEVEL`|数値入力(NP)|
|
|
14
|
+
|
|
15
|
+
数値の新規入力は、空白を除いた完全な有限JSON数値トークンを受け付け、指数表記・負のゼロ・表記を保持します。空文字、16進表記、先頭の`+`、先頭ゼロや未完成トークンは新規保存しません。既存値は開いただけで書き換えません。既存の有限数値別表記は参照用に投影し、未編集の生値を保ちます。未知の旧enum値も無操作では保存し直しません。
|
|
16
|
+
|
|
17
|
+
`MAX_BYTES` は既存処理と同じく切捨て後に安全な正の整数になる値を受け付けます。`STATUS`・`LEVEL` の既存の切捨て/補正・範囲外処理は変更しません。選択値の照合は既存処理と同じく小文字化のみで、空白を削除しません。
|
|
18
|
+
|
|
19
|
+
reporter接続は読取専用で、実行・置換しません。新しい選択や数値を保存するときだけ純粋codecとSchemaで検証します。検証失敗時は全変更を拒否し、ブロックや接続を部分的に書き換えません。
|
|
20
|
+
|
|
21
|
+
正本は本ownerの `schemas/block-editor-fixed-inputs.schema.json`、TSモジュールは選択・参照用、`dist`は生成物です。外部候補取得や実行時Schema生成は行いません。
|
|
22
|
+
|
|
23
|
+
切戻しはGUIの固定入力機能OFFで行えます。既存のプロジェクト形式・opcode・メニュー・defaultValue・実行時の処理は維持します。
|
package/docs/index.html
ADDED
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>TurboWarp-HTTP-Server documentation</title><link rel="canonical" href="https://kubohiroya.github.io/turbowarp-http-server/"><style id="block-reference-style">
|
|
3
|
+
#extension-block-reference{max-width:72rem;margin:2rem auto;padding:1rem;line-height:1.6;overflow-wrap:anywhere}
|
|
4
|
+
#extension-block-reference .block-reference-entry{display:block;scroll-margin-top:6rem;margin:2rem 0;padding:1rem;border:1px solid currentColor;border-radius:.5rem}
|
|
5
|
+
#extension-block-reference .block-reference-table{overflow-x:auto}
|
|
6
|
+
#extension-block-reference table{border-collapse:collapse;width:100%}
|
|
7
|
+
#extension-block-reference th,#extension-block-reference td{text-align:left;vertical-align:top;border:1px solid currentColor;padding:.5rem}
|
|
8
|
+
#extension-block-reference code{white-space:pre-wrap}
|
|
9
|
+
#extension-block-reference a:focus-visible{outline:3px solid currentColor;outline-offset:3px}
|
|
10
|
+
</style></head><body><p lang="en" class="complete-block-reference-link"><a href="#extension-block-reference">Complete block reference (57 blocks)</a></p><header><h1>TurboWarp-HTTP-Server</h1><p>TurboWarp extension documentation</p><a href="https://github.com/kubohiroya/turbowarp-http-server">GitHub repository</a></header><!-- BEGIN COMPLETE BLOCK REFERENCE -->
|
|
11
|
+
<section lang="en" id="extension-block-reference" aria-labelledby="block-reference-title">
|
|
12
|
+
<h2 id="block-reference-title">TurboWarp-HTTP-Server: complete block reference</h2>
|
|
13
|
+
<p>All 57 blocks are documented below, including compatibility blocks and blocks available through optional features. Select a block to read its behavior, arguments, default values, and menu choices. Each block has a permanent link.</p>
|
|
14
|
+
<nav aria-label="Block reference"><ul><li><a href="#block-setServerUrl"><code>set HTTP bridge URL to [URL]</code></a></li>
|
|
15
|
+
<li><a href="#block-connect"><code>connect to HTTP bridge</code></a></li>
|
|
16
|
+
<li><a href="#block-disconnect"><code>disconnect from HTTP bridge</code></a></li>
|
|
17
|
+
<li><a href="#block-isConnected"><code>HTTP bridge connected?</code></a></li>
|
|
18
|
+
<li><a href="#block-sendText"><code>send [MESSAGE] to HTTP bridge</code></a></li>
|
|
19
|
+
<li><a href="#block-lastMessage"><code>last HTTP bridge message</code></a></li>
|
|
20
|
+
<li><a href="#block-whenHttpRequestReceived"><code>when HTTP request received</code></a></li>
|
|
21
|
+
<li><a href="#block-useHttpRequest"><code>use HTTP request [ID]</code></a></li>
|
|
22
|
+
<li><a href="#block-currentRequestId"><code>current request ID</code></a></li>
|
|
23
|
+
<li><a href="#block-currentHttpMethod"><code>current HTTP method</code></a></li>
|
|
24
|
+
<li><a href="#block-currentRequestPath"><code>current request path</code></a></li>
|
|
25
|
+
<li><a href="#block-currentRequestUrl"><code>current request URL</code></a></li>
|
|
26
|
+
<li><a href="#block-requestHeader"><code>request header [NAME]</code></a></li>
|
|
27
|
+
<li><a href="#block-queryParameter"><code>query parameter [NAME]</code></a></li>
|
|
28
|
+
<li><a href="#block-pathParameter"><code>path parameter [NAME]</code></a></li>
|
|
29
|
+
<li><a href="#block-currentRequestBody"><code>current request body</code></a></li>
|
|
30
|
+
<li><a href="#block-currentRequestContentType"><code>current request content type</code></a></li>
|
|
31
|
+
<li><a href="#block-currentRequestClientAddress"><code>current request client address</code></a></li>
|
|
32
|
+
<li><a href="#block-setHandlerVariable"><code>set handler variable [NAME] to [VALUE]</code></a></li>
|
|
33
|
+
<li><a href="#block-changeHandlerVariable"><code>change handler variable [NAME] by [AMOUNT]</code></a></li>
|
|
34
|
+
<li><a href="#block-handlerVariable"><code>handler variable [NAME]</code></a></li>
|
|
35
|
+
<li><a href="#block-handlerVariableExists"><code>handler variable [NAME] exists?</code></a></li>
|
|
36
|
+
<li><a href="#block-deleteHandlerVariable"><code>delete handler variable [NAME]</code></a></li>
|
|
37
|
+
<li><a href="#block-clearHandlerVariables"><code>delete all handler variables</code></a></li>
|
|
38
|
+
<li><a href="#block-listHandlerVariables"><code>active handler variables</code></a></li>
|
|
39
|
+
<li><a href="#block-currentAuthType"><code>current auth type</code></a></li>
|
|
40
|
+
<li><a href="#block-currentAuthenticatedUser"><code>current authenticated user</code></a></li>
|
|
41
|
+
<li><a href="#block-currentAuthProvider"><code>current auth provider</code></a></li>
|
|
42
|
+
<li><a href="#block-currentAuthProfileJson"><code>current auth profile JSON</code></a></li>
|
|
43
|
+
<li><a href="#block-authProfileField"><code>auth profile field [NAME]</code></a></li>
|
|
44
|
+
<li><a href="#block-currentResponseStatus"><code>current response status</code></a></li>
|
|
45
|
+
<li><a href="#block-setHttpStatus"><code>set HTTP status [STATUS]</code></a></li>
|
|
46
|
+
<li><a href="#block-setResponseHeader"><code>set response header [NAME] to [VALUE]</code></a></li>
|
|
47
|
+
<li><a href="#block-removeResponseHeader"><code>remove response header [NAME]</code></a></li>
|
|
48
|
+
<li><a href="#block-responseHeader"><code>response header [NAME]</code></a></li>
|
|
49
|
+
<li><a href="#block-setResponseBody"><code>set response body [BODY]</code></a></li>
|
|
50
|
+
<li><a href="#block-sendResponse"><code>send response [BODY]</code></a></li>
|
|
51
|
+
<li><a href="#block-respondWithText"><code>respond with text [BODY]</code></a></li>
|
|
52
|
+
<li><a href="#block-respondWithHtml"><code>respond with HTML [BODY]</code></a></li>
|
|
53
|
+
<li><a href="#block-respondWithJson"><code>respond with JSON [BODY]</code></a></li>
|
|
54
|
+
<li><a href="#block-respondWithNamedBody"><code>respond with named [NAMESPACE] [NAME] kind [KIND] scope [SCOPE] target [TARGET_ID] as [REPRESENTATION] max bytes [MAX_BYTES]</code></a></li>
|
|
55
|
+
<li><a href="#block-recordHttpLog"><code>record HTTP log [ENTRY]</code></a></li>
|
|
56
|
+
<li><a href="#block-clearHttpLogs"><code>clear HTTP logs</code></a></li>
|
|
57
|
+
<li><a href="#block-httpLogViewerHtml"><code>HTTP log viewer HTML</code></a></li>
|
|
58
|
+
<li><a href="#block-httpLogViewerHtmlFromJson"><code>HTTP log viewer HTML from [LOGS]</code></a></li>
|
|
59
|
+
<li><a href="#block-newMarkdownDocument"><code>new markdown document</code></a></li>
|
|
60
|
+
<li><a href="#block-markdownHeading"><code>markdown [DOC] with heading level [LEVEL] [TEXT]</code></a></li>
|
|
61
|
+
<li><a href="#block-markdownParagraph"><code>markdown [DOC] with paragraph [TEXT]</code></a></li>
|
|
62
|
+
<li><a href="#block-markdownBullet"><code>markdown [DOC] with bullet [TEXT]</code></a></li>
|
|
63
|
+
<li><a href="#block-markdownCodeBlock"><code>markdown [DOC] with code [CODE] language [LANG]</code></a></li>
|
|
64
|
+
<li><a href="#block-renderMarkdown"><code>render markdown [DOC]</code></a></li>
|
|
65
|
+
<li><a href="#block-newHtmlElement"><code>new HTML element [TAG]</code></a></li>
|
|
66
|
+
<li><a href="#block-htmlText"><code>HTML text [TEXT]</code></a></li>
|
|
67
|
+
<li><a href="#block-htmlSetAttribute"><code>HTML [NODE] with attribute [NAME] [VALUE]</code></a></li>
|
|
68
|
+
<li><a href="#block-htmlAppendChild"><code>HTML [PARENT] with child [CHILD]</code></a></li>
|
|
69
|
+
<li><a href="#block-renderHtml"><code>render HTML [NODE]</code></a></li>
|
|
70
|
+
<li><a href="#block-renderHtmlDocument"><code>render HTML document title [TITLE] body [BODY]</code></a></li>
|
|
71
|
+
</ul></nav>
|
|
72
|
+
<article id="block-setServerUrl" class="block-reference-entry"><h3><code>set HTTP bridge URL to [URL]</code></h3><p>Sets the WebSocket URL used to reach the HTTP bridge server.</p><p>Block type: COMMAND. Opcode: <code>setServerUrl</code>. <a href="#block-setServerUrl">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>URL</code></th><td>STRING</td><td><code>ws://127.0.0.1:8787/ws</code></td><td></td></tr></tbody></table></div></article><article id="block-connect" class="block-reference-entry"><h3><code>connect to HTTP bridge</code></h3><p>Opens a WebSocket connection to the configured HTTP bridge server.</p><p>Block type: COMMAND. Opcode: <code>connect</code>. <a href="#block-connect">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-disconnect" class="block-reference-entry"><h3><code>disconnect from HTTP bridge</code></h3><p>Closes the current bridge connection.</p><p>Block type: COMMAND. Opcode: <code>disconnect</code>. <a href="#block-disconnect">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-isConnected" class="block-reference-entry"><h3><code>HTTP bridge connected?</code></h3><p>Reports whether the bridge WebSocket is currently open.</p><p>Block type: BOOLEAN. Opcode: <code>isConnected</code>. <a href="#block-isConnected">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-sendText" class="block-reference-entry"><h3><code>send [MESSAGE] to HTTP bridge</code></h3><p>Sends a text message to the connected HTTP bridge server.</p><p>Block type: COMMAND. Opcode: <code>sendText</code>. <a href="#block-sendText">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>MESSAGE</code></th><td>STRING</td><td><code>{"type":"ping"}</code></td><td></td></tr></tbody></table></div></article><article id="block-lastMessage" class="block-reference-entry"><h3><code>last HTTP bridge message</code></h3><p>Returns the most recent text message received from the bridge.</p><p>Block type: REPORTER. Opcode: <code>lastMessage</code>. <a href="#block-lastMessage">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-whenHttpRequestReceived" class="block-reference-entry"><h3><code>when HTTP request received</code></h3><p>Starts a TurboWarp handler thread when the bridge receives an HTTP request.</p><p>Block type: HAT. Opcode: <code>whenHttpRequestReceived</code>. <a href="#block-whenHttpRequestReceived">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-useHttpRequest" class="block-reference-entry"><h3><code>use HTTP request [ID]</code></h3><p>Selects a pending request context by request ID.</p><p>Block type: COMMAND. Opcode: <code>useHttpRequest</code>. <a href="#block-useHttpRequest">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>ID</code></th><td>STRING</td><td><code>req-1</code></td><td></td></tr></tbody></table></div></article><article id="block-currentRequestId" class="block-reference-entry"><h3><code>current request ID</code></h3><p>Returns the current HTTP request ID.</p><p>Block type: REPORTER. Opcode: <code>currentRequestId</code>. <a href="#block-currentRequestId">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentHttpMethod" class="block-reference-entry"><h3><code>current HTTP method</code></h3><p>Returns the current HTTP request method.</p><p>Block type: REPORTER. Opcode: <code>currentHttpMethod</code>. <a href="#block-currentHttpMethod">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentRequestPath" class="block-reference-entry"><h3><code>current request path</code></h3><p>Returns the current HTTP request path.</p><p>Block type: REPORTER. Opcode: <code>currentRequestPath</code>. <a href="#block-currentRequestPath">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentRequestUrl" class="block-reference-entry"><h3><code>current request URL</code></h3><p>Returns the current HTTP request URL.</p><p>Block type: REPORTER. Opcode: <code>currentRequestUrl</code>. <a href="#block-currentRequestUrl">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-requestHeader" class="block-reference-entry"><h3><code>request header [NAME]</code></h3><p>Returns the first value of a request header using case-insensitive lookup.</p><p>Block type: REPORTER. Opcode: <code>requestHeader</code>. <a href="#block-requestHeader">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>accept</code></td><td></td></tr></tbody></table></div></article><article id="block-queryParameter" class="block-reference-entry"><h3><code>query parameter [NAME]</code></h3><p>Returns the first query parameter value.</p><p>Block type: REPORTER. Opcode: <code>queryParameter</code>. <a href="#block-queryParameter">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>q</code></td><td></td></tr></tbody></table></div></article><article id="block-pathParameter" class="block-reference-entry"><h3><code>path parameter [NAME]</code></h3><p>Returns a route path parameter value.</p><p>Block type: REPORTER. Opcode: <code>pathParameter</code>. <a href="#block-pathParameter">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>id</code></td><td></td></tr></tbody></table></div></article><article id="block-currentRequestBody" class="block-reference-entry"><h3><code>current request body</code></h3><p>Returns the current textual request body, or an empty string for non-text bodies.</p><p>Block type: REPORTER. Opcode: <code>currentRequestBody</code>. <a href="#block-currentRequestBody">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentRequestContentType" class="block-reference-entry"><h3><code>current request content type</code></h3><p>Returns the current request Content-Type header.</p><p>Block type: REPORTER. Opcode: <code>currentRequestContentType</code>. <a href="#block-currentRequestContentType">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentRequestClientAddress" class="block-reference-entry"><h3><code>current request client address</code></h3><p>Returns the current request client address when available.</p><p>Block type: REPORTER. Opcode: <code>currentRequestClientAddress</code>. <a href="#block-currentRequestClientAddress">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-setHandlerVariable" class="block-reference-entry"><h3><code>set handler variable [NAME] to [VALUE]</code></h3><p>Sets a request-local variable that is discarded when the current HTTP response completes.</p><p>Block type: COMMAND. Opcode: <code>setHandlerVariable</code>. <a href="#block-setHandlerVariable">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>value</code></td><td></td></tr><tr><th scope="row"><code>VALUE</code></th><td>STRING</td><td><code>0</code></td><td></td></tr></tbody></table></div></article><article id="block-changeHandlerVariable" class="block-reference-entry"><h3><code>change handler variable [NAME] by [AMOUNT]</code></h3><p>Changes a request-local numeric variable using Scratch number conversion rules.</p><p>Block type: COMMAND. Opcode: <code>changeHandlerVariable</code>. <a href="#block-changeHandlerVariable">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>value</code></td><td></td></tr><tr><th scope="row"><code>AMOUNT</code></th><td>NUMBER</td><td><code>1</code></td><td></td></tr></tbody></table></div><p lang="ja" class="fixed-input-help"><a href="#fixed-input-editors">このブロックの固定入力編集と互換性</a></p>
|
|
73
|
+
</article><article id="block-handlerVariable" class="block-reference-entry"><h3><code>handler variable [NAME]</code></h3><p>Returns a request-local handler variable, or an empty string when it does not exist.</p><p>Block type: REPORTER. Opcode: <code>handlerVariable</code>. <a href="#block-handlerVariable">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>value</code></td><td></td></tr></tbody></table></div></article><article id="block-handlerVariableExists" class="block-reference-entry"><h3><code>handler variable [NAME] exists?</code></h3><p>Reports whether a request-local handler variable exists.</p><p>Block type: BOOLEAN. Opcode: <code>handlerVariableExists</code>. <a href="#block-handlerVariableExists">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>value</code></td><td></td></tr></tbody></table></div></article><article id="block-deleteHandlerVariable" class="block-reference-entry"><h3><code>delete handler variable [NAME]</code></h3><p>Deletes a request-local handler variable.</p><p>Block type: COMMAND. Opcode: <code>deleteHandlerVariable</code>. <a href="#block-deleteHandlerVariable">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>value</code></td><td></td></tr></tbody></table></div></article><article id="block-clearHandlerVariables" class="block-reference-entry"><h3><code>delete all handler variables</code></h3><p>Deletes all request-local handler variables for the current HTTP handler.</p><p>Block type: COMMAND. Opcode: <code>clearHandlerVariables</code>. <a href="#block-clearHandlerVariables">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-listHandlerVariables" class="block-reference-entry"><h3><code>active handler variables</code></h3><p>Returns comma-separated names of request-local handler variables.</p><p>Block type: REPORTER. Opcode: <code>listHandlerVariables</code>. <a href="#block-listHandlerVariables">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentAuthType" class="block-reference-entry"><h3><code>current auth type</code></h3><p>Returns the current authentication type, such as digest or oauth.</p><p>Block type: REPORTER. Opcode: <code>currentAuthType</code>. <a href="#block-currentAuthType">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentAuthenticatedUser" class="block-reference-entry"><h3><code>current authenticated user</code></h3><p>Returns the authenticated username or a stable user-like profile field when available.</p><p>Block type: REPORTER. Opcode: <code>currentAuthenticatedUser</code>. <a href="#block-currentAuthenticatedUser">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentAuthProvider" class="block-reference-entry"><h3><code>current auth provider</code></h3><p>Returns the authentication provider name when available.</p><p>Block type: REPORTER. Opcode: <code>currentAuthProvider</code>. <a href="#block-currentAuthProvider">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentAuthProfileJson" class="block-reference-entry"><h3><code>current auth profile JSON</code></h3><p>Returns the provider profile object as JSON when available.</p><p>Block type: REPORTER. Opcode: <code>currentAuthProfileJson</code>. <a href="#block-currentAuthProfileJson">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-authProfileField" class="block-reference-entry"><h3><code>auth profile field [NAME]</code></h3><p>Returns a top-level or dotted field from the provider profile object.</p><p>Block type: REPORTER. Opcode: <code>authProfileField</code>. <a href="#block-authProfileField">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>email</code></td><td></td></tr></tbody></table></div></article><article id="block-currentResponseStatus" class="block-reference-entry"><h3><code>current response status</code></h3><p>Returns the response status currently being built.</p><p>Block type: REPORTER. Opcode: <code>currentResponseStatus</code>. <a href="#block-currentResponseStatus">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-setHttpStatus" class="block-reference-entry"><h3><code>set HTTP status [STATUS]</code></h3><p>Sets the current response status.</p><p>Block type: COMMAND. Opcode: <code>setHttpStatus</code>. <a href="#block-setHttpStatus">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>STATUS</code></th><td>NUMBER</td><td><code>200</code></td><td></td></tr></tbody></table></div><p lang="ja" class="fixed-input-help"><a href="#fixed-input-editors">このブロックの固定入力編集と互換性</a></p>
|
|
74
|
+
</article><article id="block-setResponseHeader" class="block-reference-entry"><h3><code>set response header [NAME] to [VALUE]</code></h3><p>Sets a response header for the current request.</p><p>Block type: COMMAND. Opcode: <code>setResponseHeader</code>. <a href="#block-setResponseHeader">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>content-type</code></td><td></td></tr><tr><th scope="row"><code>VALUE</code></th><td>STRING</td><td><code>text/plain; charset=utf-8</code></td><td></td></tr></tbody></table></div></article><article id="block-removeResponseHeader" class="block-reference-entry"><h3><code>remove response header [NAME]</code></h3><p>Removes a response header for the current request.</p><p>Block type: COMMAND. Opcode: <code>removeResponseHeader</code>. <a href="#block-removeResponseHeader">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>content-type</code></td><td></td></tr></tbody></table></div></article><article id="block-responseHeader" class="block-reference-entry"><h3><code>response header [NAME]</code></h3><p>Returns the first configured response header value.</p><p>Block type: REPORTER. Opcode: <code>responseHeader</code>. <a href="#block-responseHeader">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>content-type</code></td><td></td></tr></tbody></table></div></article><article id="block-setResponseBody" class="block-reference-entry"><h3><code>set response body [BODY]</code></h3><p>Sets the current response body without completing the response.</p><p>Block type: COMMAND. Opcode: <code>setResponseBody</code>. <a href="#block-setResponseBody">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>BODY</code></th><td>STRING</td><td><code>Hello</code></td><td></td></tr></tbody></table></div></article><article id="block-sendResponse" class="block-reference-entry"><h3><code>send response [BODY]</code></h3><p>Sets the response body and completes the current request.</p><p>Block type: COMMAND. Opcode: <code>sendResponse</code>. <a href="#block-sendResponse">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>BODY</code></th><td>STRING</td><td><code>Hello</code></td><td></td></tr></tbody></table></div></article><article id="block-respondWithText" class="block-reference-entry"><h3><code>respond with text [BODY]</code></h3><p>Responds with plain text.</p><p>Block type: COMMAND. Opcode: <code>respondWithText</code>. <a href="#block-respondWithText">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>BODY</code></th><td>STRING</td><td><code>Hello</code></td><td></td></tr></tbody></table></div></article><article id="block-respondWithHtml" class="block-reference-entry"><h3><code>respond with HTML [BODY]</code></h3><p>Responds with HTML.</p><p>Block type: COMMAND. Opcode: <code>respondWithHtml</code>. <a href="#block-respondWithHtml">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>BODY</code></th><td>STRING</td><td><code><p>Hello</p></code></td><td></td></tr></tbody></table></div></article><article id="block-respondWithJson" class="block-reference-entry"><h3><code>respond with JSON [BODY]</code></h3><p>Responds with JSON.</p><p>Block type: COMMAND. Opcode: <code>respondWithJson</code>. <a href="#block-respondWithJson">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>BODY</code></th><td>STRING</td><td><code>{"ok":true}</code></td><td></td></tr></tbody></table></div></article><article id="block-respondWithNamedBody" class="block-reference-entry"><h3><code>respond with named [NAMESPACE] [NAME] kind [KIND] scope [SCOPE] target [TARGET_ID] as [REPRESENTATION] max bytes [MAX_BYTES]</code></h3><p>Completes the response with a named structured, document, binary, or asset snapshot resolved by the server.</p><p>Block type: COMMAND. Opcode: <code>respondWithNamedBody</code>. <a href="#block-respondWithNamedBody">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAMESPACE</code></th><td>STRING</td><td><code>asset</code></td><td></td></tr><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>avatar</code></td><td></td></tr><tr><th scope="row"><code>KIND</code></th><td>STRING</td><td><code>asset</code></td><td></td></tr><tr><th scope="row"><code>SCOPE</code></th><td>STRING</td><td><code>project</code></td><td></td></tr><tr><th scope="row"><code>TARGET_ID</code></th><td>STRING</td><td><code>Stage:1</code></td><td></td></tr><tr><th scope="row"><code>REPRESENTATION</code></th><td>STRING</td><td><code>raw</code></td><td></td></tr><tr><th scope="row"><code>MAX_BYTES</code></th><td>NUMBER</td><td><code>10485760</code></td><td></td></tr></tbody></table></div><p lang="ja" class="fixed-input-help"><a href="#fixed-input-editors">このブロックの固定入力編集と互換性</a></p>
|
|
75
|
+
</article><article id="block-recordHttpLog" class="block-reference-entry"><h3><code>record HTTP log [ENTRY]</code></h3><p>Adds a structured HTTP log entry JSON string to the extension log buffer.</p><p>Block type: COMMAND. Opcode: <code>recordHttpLog</code>. <a href="#block-recordHttpLog">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>ENTRY</code></th><td>STRING</td><td><code>{"method":"GET","path":"/","status":200}</code></td><td></td></tr></tbody></table></div></article><article id="block-clearHttpLogs" class="block-reference-entry"><h3><code>clear HTTP logs</code></h3><p>Clears the extension log buffer.</p><p>Block type: COMMAND. Opcode: <code>clearHttpLogs</code>. <a href="#block-clearHttpLogs">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-httpLogViewerHtml" class="block-reference-entry"><h3><code>HTTP log viewer HTML</code></h3><p>Returns a self-contained virtual-scroll HTML log viewer for buffered HTTP logs.</p><p>Block type: REPORTER. Opcode: <code>httpLogViewerHtml</code>. <a href="#block-httpLogViewerHtml">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-httpLogViewerHtmlFromJson" class="block-reference-entry"><h3><code>HTTP log viewer HTML from [LOGS]</code></h3><p>Returns a self-contained virtual-scroll HTML log viewer from a JSON array of log entries.</p><p>Block type: REPORTER. Opcode: <code>httpLogViewerHtmlFromJson</code>. <a href="#block-httpLogViewerHtmlFromJson">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>LOGS</code></th><td>STRING</td><td><code>[{"method":"GET","path":"/","status":200}]</code></td><td></td></tr></tbody></table></div></article><article id="block-newMarkdownDocument" class="block-reference-entry"><h3><code>new markdown document</code></h3><p>Creates an empty Markdown builder handle.</p><p>Block type: REPORTER. Opcode: <code>newMarkdownDocument</code>. <a href="#block-newMarkdownDocument">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-markdownHeading" class="block-reference-entry"><h3><code>markdown [DOC] with heading level [LEVEL] [TEXT]</code></h3><p>Appends a Markdown heading and returns the same builder handle.</p><p>Block type: REPORTER. Opcode: <code>markdownHeading</code>. <a href="#block-markdownHeading">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>DOC</code></th><td>STRING</td><td><code>md:1</code></td><td></td></tr><tr><th scope="row"><code>LEVEL</code></th><td>NUMBER</td><td><code>1</code></td><td></td></tr><tr><th scope="row"><code>TEXT</code></th><td>STRING</td><td><code>Title</code></td><td></td></tr></tbody></table></div><p lang="ja" class="fixed-input-help"><a href="#fixed-input-editors">このブロックの固定入力編集と互換性</a></p>
|
|
76
|
+
</article><article id="block-markdownParagraph" class="block-reference-entry"><h3><code>markdown [DOC] with paragraph [TEXT]</code></h3><p>Appends a Markdown paragraph and returns the same builder handle.</p><p>Block type: REPORTER. Opcode: <code>markdownParagraph</code>. <a href="#block-markdownParagraph">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>DOC</code></th><td>STRING</td><td><code>md:1</code></td><td></td></tr><tr><th scope="row"><code>TEXT</code></th><td>STRING</td><td><code>Hello</code></td><td></td></tr></tbody></table></div></article><article id="block-markdownBullet" class="block-reference-entry"><h3><code>markdown [DOC] with bullet [TEXT]</code></h3><p>Appends a Markdown bullet and returns the same builder handle.</p><p>Block type: REPORTER. Opcode: <code>markdownBullet</code>. <a href="#block-markdownBullet">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>DOC</code></th><td>STRING</td><td><code>md:1</code></td><td></td></tr><tr><th scope="row"><code>TEXT</code></th><td>STRING</td><td><code>Item</code></td><td></td></tr></tbody></table></div></article><article id="block-markdownCodeBlock" class="block-reference-entry"><h3><code>markdown [DOC] with code [CODE] language [LANG]</code></h3><p>Appends a fenced Markdown code block and returns the same builder handle.</p><p>Block type: REPORTER. Opcode: <code>markdownCodeBlock</code>. <a href="#block-markdownCodeBlock">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>DOC</code></th><td>STRING</td><td><code>md:1</code></td><td></td></tr><tr><th scope="row"><code>CODE</code></th><td>STRING</td><td><code>console.log('hello')</code></td><td></td></tr><tr><th scope="row"><code>LANG</code></th><td>STRING</td><td><code>js</code></td><td></td></tr></tbody></table></div></article><article id="block-renderMarkdown" class="block-reference-entry"><h3><code>render markdown [DOC]</code></h3><p>Renders a Markdown builder handle to Markdown text.</p><p>Block type: REPORTER. Opcode: <code>renderMarkdown</code>. <a href="#block-renderMarkdown">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>DOC</code></th><td>STRING</td><td><code>md:1</code></td><td></td></tr></tbody></table></div></article><article id="block-newHtmlElement" class="block-reference-entry"><h3><code>new HTML element [TAG]</code></h3><p>Creates an HTML element builder handle.</p><p>Block type: REPORTER. Opcode: <code>newHtmlElement</code>. <a href="#block-newHtmlElement">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>TAG</code></th><td>STRING</td><td><code>div</code></td><td></td></tr></tbody></table></div></article><article id="block-htmlText" class="block-reference-entry"><h3><code>HTML text [TEXT]</code></h3><p>Creates an escaped HTML text node handle.</p><p>Block type: REPORTER. Opcode: <code>htmlText</code>. <a href="#block-htmlText">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>TEXT</code></th><td>STRING</td><td><code>Hello</code></td><td></td></tr></tbody></table></div></article><article id="block-htmlSetAttribute" class="block-reference-entry"><h3><code>HTML [NODE] with attribute [NAME] [VALUE]</code></h3><p>Sets an escaped attribute on an HTML element and returns the same handle.</p><p>Block type: REPORTER. Opcode: <code>htmlSetAttribute</code>. <a href="#block-htmlSetAttribute">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NODE</code></th><td>STRING</td><td><code>html:1</code></td><td></td></tr><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>class</code></td><td></td></tr><tr><th scope="row"><code>VALUE</code></th><td>STRING</td><td><code>content</code></td><td></td></tr></tbody></table></div></article><article id="block-htmlAppendChild" class="block-reference-entry"><h3><code>HTML [PARENT] with child [CHILD]</code></h3><p>Appends a child node to an HTML element and returns the parent handle.</p><p>Block type: REPORTER. Opcode: <code>htmlAppendChild</code>. <a href="#block-htmlAppendChild">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>PARENT</code></th><td>STRING</td><td><code>html:1</code></td><td></td></tr><tr><th scope="row"><code>CHILD</code></th><td>STRING</td><td><code>html:2</code></td><td></td></tr></tbody></table></div></article><article id="block-renderHtml" class="block-reference-entry"><h3><code>render HTML [NODE]</code></h3><p>Renders an HTML node handle to an HTML fragment.</p><p>Block type: REPORTER. Opcode: <code>renderHtml</code>. <a href="#block-renderHtml">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NODE</code></th><td>STRING</td><td><code>html:1</code></td><td></td></tr></tbody></table></div></article><article id="block-renderHtmlDocument" class="block-reference-entry"><h3><code>render HTML document title [TITLE] body [BODY]</code></h3><p>Renders a full HTML document from an HTML body node handle.</p><p>Block type: REPORTER. Opcode: <code>renderHtmlDocument</code>. <a href="#block-renderHtmlDocument">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>TITLE</code></th><td>STRING</td><td><code>Page</code></td><td></td></tr><tr><th scope="row"><code>BODY</code></th><td>STRING</td><td><code>html:1</code></td><td></td></tr></tbody></table></div></article>
|
|
77
|
+
<p><a href="https://github.com/kubohiroya/turbowarp-http-server/blob/main/README.md">Repository guide and examples</a></p>
|
|
78
|
+
</section>
|
|
79
|
+
<!-- END COMPLETE BLOCK REFERENCE --><section lang="ja" id="fixed-input-editors"><h2>固定入力の編集</h2><p>対応GUIの固定入力機能は既定OFFです。既存値は開いただけでは変更せず、reporter接続は評価・置換しません。新しい選択と有限JSON数値入力のみを検証して保存し、既存の補正・丸め処理を維持します。機能OFFで従来の編集へ戻せます。</p><p><a href="fixed-input-editors.ja.md">対象入力・Schemaの正本・互換性・切戻し</a></p></section>
|
|
80
|
+
</body></html>
|