@akanjs/cli 3.3.0-rc.11 → 3.3.0-rc.13
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/.build-stamp +2 -2
- package/{CodeAgent-cqbf9gsv.js → CodeAgent-zkr3s3xy.js} +2 -2
- package/{CodeTui-ehdr4hgw.js → CodeTui-1qvrzfmy.js} +1 -1
- package/TunnelShare-8j95ta3w.js +16 -0
- package/{agent.command-x55ncdjm.js → agent.command-dejgb8vz.js} +18 -17
- package/akanCode.js +2 -2
- package/{appExecutor-1ctzymwa.js → appExecutor-nj95a6en.js} +3 -3
- package/{application.command-xpntxnh8.js → application.command-3tnq1587.js} +45 -15
- package/{applicationBuildRunner-19c76791.js → applicationBuildRunner-cbjy05yg.js} +75 -12
- package/buildBatch.proc.js +10 -10
- package/{cloud.command-p3ybjes7.js → cloud.command-qae6et2e.js} +19 -18
- package/cloud.script-34xmprty.js +31 -0
- package/{code.command-m6skj1kj.js → code.command-xrh506zf.js} +10 -10
- package/commandManifest.json +1 -1
- package/{context.command-3c3nv0d6.js → context.command-fxyzkwg5.js} +18 -18
- package/context.runner-bz1jwxkk.js +32 -0
- package/{csrArtifactBuilder-mdh9ykn2.js → csrArtifactBuilder-rqg85wbg.js} +2 -2
- package/{guideline.command-725fq5p0.js → guideline.command-7dgscqjq.js} +6 -6
- package/guidelines/akanApi/akanApi.instruction.md +10 -0
- package/guidelines/conventions/rules/config.md +5 -0
- package/guidelines/conventions/rules/page.md +4 -3
- package/guidelines/conventions/rules/server.md +21 -81
- package/guidelines/conventions/rules/ssr.md +4 -25
- package/guidelines/conventions/rules/style.md +9 -32
- package/guidelines/cssRule/cssRule.instruction.md +11 -4
- package/guidelines/errorCodes/errorCodes.instruction.md +4 -0
- package/guidelines/pageRule/pageRule.instruction.md +19 -0
- package/guidelines/recipeRule/recipeRule.instruction.md +3 -3
- package/guidelines/runtimeRule/runtimeRule.instruction.md +109 -6
- package/guidelines/ssrRule/ssrRule.instruction.md +3 -0
- package/guidelines/transportRule/transportRule.instruction.md +4 -0
- package/incrementalBuilder.proc.js +8 -8
- package/{index-3mj5trqc.js → index-0bzrcv91.js} +1 -1
- package/{index-q63nbpv7.js → index-0zkxsdsg.js} +3 -3
- package/{index-wxqp1amd.js → index-1c52g4st.js} +11 -9
- package/{index-vnk1qwgr.js → index-22h6vq3f.js} +4 -4
- package/index-35p43f33.js +16 -0
- package/{index-fagjtk6m.js → index-3q7ectss.js} +2 -2
- package/{index-se7n78fh.js → index-54g085ty.js} +1 -1
- package/{index-rt7q20sj.js → index-5sa1tr7w.js} +1 -1
- package/{index-h8w1n11r.js → index-6a3rmwxx.js} +4 -4
- package/{index-yey1envc.js → index-741xbhes.js} +1 -1
- package/{index-9a9t77hz.js → index-77627y32.js} +2 -2
- package/{index-4r8dgm4x.js → index-8javbznc.js} +3 -3
- package/{index-hxg6ctk2.js → index-a2a3nh57.js} +3 -3
- package/{index-j2wq064m.js → index-aezpcphy.js} +121 -15
- package/{index-3r1crbct.js → index-ay4vkwr8.js} +1 -1
- package/{index-t23dgyaf.js → index-b4m7bjbx.js} +7 -7
- package/{index-rdcgz02t.js → index-bma8tmgb.js} +4 -4
- package/{index-3zkhg65e.js → index-c4g8egm2.js} +40 -13
- package/{index-9gjcbp2g.js → index-c8kj74zz.js} +1 -1
- package/{index-fjqapyex.js → index-es2wkn41.js} +40 -5
- package/{index-pyjkbg8e.js → index-extg77rx.js} +2 -2
- package/{index-nmdmkjt2.js → index-fey1dd49.js} +4 -4
- package/{index-c669pbyb.js → index-fjzeak0t.js} +68 -37
- package/{index-f4jydw2x.js → index-gdgbgn82.js} +1 -1
- package/{index-4yvtqcme.js → index-gyyscjzx.js} +16 -4
- package/{index-qecrqpt6.js → index-hxcefw29.js} +1 -1
- package/{index-a4gcdffy.js → index-k380ww64.js} +3 -3
- package/index-kqxs1d7z.js +377 -0
- package/{index-nnmw56fz.js → index-mv3ke0fc.js} +5 -5
- package/{index-m303nhv6.js → index-mvdmb73w.js} +6 -6
- package/{index-cbm9gzgx.js → index-pa53zktp.js} +5 -5
- package/{index-3a3vy2xy.js → index-psvxwemh.js} +8 -8
- package/{index-ckcc9ab3.js → index-r24mj2pw.js} +8 -8
- package/{index-8bta5pnr.js → index-serpfvat.js} +2 -2
- package/{index-kbnvyhy4.js → index-shjjjdte.js} +3 -3
- package/{index-pr9nypg7.js → index-sjmk7wp7.js} +2 -2
- package/{index-wkwe91sn.js → index-th7qbjfz.js} +11 -11
- package/{index-5ahe641t.js → index-vgd07z61.js} +8 -8
- package/{index-crd99zqs.js → index-wzvvqkcy.js} +1 -1
- package/{index-v16gj2as.js → index-ys1sjp6m.js} +90 -51
- package/{index-22bwg8hy.js → index-zc43cyg8.js} +1 -1
- package/index.js +27 -27
- package/{libExecutor-n8hpm8s7.js → libExecutor-mqxnn0h6.js} +2 -2
- package/{library.command-8abb26pg.js → library.command-4kefxh8z.js} +7 -7
- package/{localRegistry.command-sa211m1z.js → localRegistry.command-phgrhkks.js} +18 -17
- package/{module.command-z3cwjf0p.js → module.command-8476gwze.js} +9 -9
- package/{package.command-akynhtee.js → package.command-ygxm5pp9.js} +8 -8
- package/package.json +2 -2
- package/{page.command-3fpdavk9.js → page.command-f7fwkj8y.js} +7 -7
- package/{pipeline.command-ca95n8rd.js → pipeline.command-9htjbrdm.js} +6 -6
- package/{pkgExecutor-a73q41vx.js → pkgExecutor-6a91xng5.js} +2 -2
- package/{primitive.command-xwe9ggnf.js → primitive.command-0k0h0cm0.js} +10 -10
- package/{projectTypecheck-7g542ymk.js → projectTypecheck-7kakbacs.js} +1 -1
- package/{quality.command-7wz7y8z1.js → quality.command-frsfdfc5.js} +9 -8
- package/{repair.command-dej1qtfq.js → repair.command-yag3bpq2.js} +9 -9
- package/{scalar.command-z9qfxnvm.js → scalar.command-qtyrywvt.js} +8 -8
- package/skills/akan-err/SKILL.md +11 -2
- package/skills/akan-page/SKILL.md +4 -14
- package/skills/akan-runtime/SKILL.md +20 -0
- package/{subspace.command-9wekm4gn.js → subspace.command-kr53abzt.js} +10 -10
- package/{tunnel.command-cxc4h3j8.js → tunnel.command-pswe6nye.js} +9 -9
- package/{typeChecker-7jt6abrs.js → typeChecker-epg7ebfy.js} +2 -1
- package/typecheck.proc.js +2 -1
- package/{verify.command-j0w9dr5c.js → verify.command-ghhhzgrw.js} +15 -14
- package/{workflow.command-yt4sz04b.js → workflow.command-fpwqth4w.js} +14 -14
- package/{workspace.command-8mp4mcp2.js → workspace.command-6bbmtn3w.js} +33 -31
- package/TunnelShare-0p4dy89e.js +0 -16
- package/cloud.script-0dsyd10v.js +0 -30
- package/context.runner-yyp7a112.js +0 -32
|
@@ -3,18 +3,18 @@ import {
|
|
|
3
3
|
Pkg,
|
|
4
4
|
Workspace,
|
|
5
5
|
command
|
|
6
|
-
} from "./index-
|
|
6
|
+
} from "./index-mv3ke0fc.js";
|
|
7
7
|
import"./index-j4yvgfhr.js";
|
|
8
|
-
import"./index-
|
|
8
|
+
import"./index-ys1sjp6m.js";
|
|
9
9
|
import"./index-zyjztrvc.js";
|
|
10
|
-
import"./index-
|
|
11
|
-
import"./index-
|
|
12
|
-
import"./index-
|
|
13
|
-
import"./index-
|
|
10
|
+
import"./index-77627y32.js";
|
|
11
|
+
import"./index-741xbhes.js";
|
|
12
|
+
import"./index-wzvvqkcy.js";
|
|
13
|
+
import"./index-54g085ty.js";
|
|
14
14
|
import {
|
|
15
15
|
PackageScript
|
|
16
|
-
} from "./index-
|
|
17
|
-
import"./index-
|
|
16
|
+
} from "./index-a2a3nh57.js";
|
|
17
|
+
import"./index-ay4vkwr8.js";
|
|
18
18
|
|
|
19
19
|
// pkgs/@akanjs/cli/package/package.command.ts
|
|
20
20
|
class PackageCommand extends command("package", [PackageScript], ({ public: target }) => ({
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@akanjs/cli",
|
|
3
|
-
"version": "3.3.0-rc.
|
|
3
|
+
"version": "3.3.0-rc.13",
|
|
4
4
|
"sourceType": "module",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"publishConfig": {
|
|
@@ -40,7 +40,7 @@
|
|
|
40
40
|
"@earendil-works/pi-tui": "1.5.2",
|
|
41
41
|
"@inquirer/prompts": "^8.7.3",
|
|
42
42
|
"@tailwindcss/node": "^4.3.3",
|
|
43
|
-
"akanjs": "3.3.0-rc.
|
|
43
|
+
"akanjs": "3.3.0-rc.13",
|
|
44
44
|
"chalk": "^6.0.1",
|
|
45
45
|
"commander": "^15.0.0",
|
|
46
46
|
"dayjs": "^1.11.23",
|
|
@@ -3,17 +3,17 @@ import {
|
|
|
3
3
|
App,
|
|
4
4
|
Module,
|
|
5
5
|
command
|
|
6
|
-
} from "./index-
|
|
6
|
+
} from "./index-mv3ke0fc.js";
|
|
7
7
|
import"./index-j4yvgfhr.js";
|
|
8
|
-
import"./index-
|
|
8
|
+
import"./index-ys1sjp6m.js";
|
|
9
9
|
import"./index-zyjztrvc.js";
|
|
10
|
-
import"./index-
|
|
11
|
-
import"./index-
|
|
12
|
-
import"./index-
|
|
10
|
+
import"./index-77627y32.js";
|
|
11
|
+
import"./index-741xbhes.js";
|
|
12
|
+
import"./index-wzvvqkcy.js";
|
|
13
13
|
import {
|
|
14
14
|
PageScript
|
|
15
|
-
} from "./index-
|
|
16
|
-
import"./index-
|
|
15
|
+
} from "./index-c8kj74zz.js";
|
|
16
|
+
import"./index-ay4vkwr8.js";
|
|
17
17
|
|
|
18
18
|
// pkgs/@akanjs/cli/page/page.command.ts
|
|
19
19
|
class PageCommand extends command("page", [PageScript], ({ public: target }) => ({
|
|
@@ -4,24 +4,24 @@ import {
|
|
|
4
4
|
runner,
|
|
5
5
|
script,
|
|
6
6
|
command
|
|
7
|
-
} from "./index-
|
|
7
|
+
} from "./index-mv3ke0fc.js";
|
|
8
8
|
import"./index-j4yvgfhr.js";
|
|
9
9
|
import {
|
|
10
10
|
AkanAppConfig,
|
|
11
11
|
AkanWorkspaceConfig
|
|
12
|
-
} from "./index-
|
|
12
|
+
} from "./index-ys1sjp6m.js";
|
|
13
13
|
import {
|
|
14
14
|
FileSys2
|
|
15
15
|
} from "./index-zyjztrvc.js";
|
|
16
16
|
import {
|
|
17
17
|
AppExecutor2
|
|
18
|
-
} from "./index-
|
|
19
|
-
import"./index-
|
|
20
|
-
import"./index-
|
|
18
|
+
} from "./index-77627y32.js";
|
|
19
|
+
import"./index-741xbhes.js";
|
|
20
|
+
import"./index-wzvvqkcy.js";
|
|
21
21
|
import {
|
|
22
22
|
resolveMobileTargets
|
|
23
23
|
} from "./index-m9jj544v.js";
|
|
24
|
-
import"./index-
|
|
24
|
+
import"./index-ay4vkwr8.js";
|
|
25
25
|
|
|
26
26
|
// pkgs/@akanjs/cli/pipeline/pipeline.command.ts
|
|
27
27
|
import { pipelineTriggers as pipelineTriggers2 } from "akanjs/common";
|
|
@@ -2,23 +2,23 @@
|
|
|
2
2
|
import {
|
|
3
3
|
Workspace,
|
|
4
4
|
command
|
|
5
|
-
} from "./index-
|
|
5
|
+
} from "./index-mv3ke0fc.js";
|
|
6
6
|
import"./index-j4yvgfhr.js";
|
|
7
|
-
import"./index-
|
|
7
|
+
import"./index-ys1sjp6m.js";
|
|
8
8
|
import"./index-zyjztrvc.js";
|
|
9
|
-
import"./index-
|
|
10
|
-
import"./index-
|
|
11
|
-
import"./index-
|
|
9
|
+
import"./index-77627y32.js";
|
|
10
|
+
import"./index-741xbhes.js";
|
|
11
|
+
import"./index-wzvvqkcy.js";
|
|
12
12
|
import {
|
|
13
13
|
renderPrimitiveReport
|
|
14
|
-
} from "./index-
|
|
14
|
+
} from "./index-0zkxsdsg.js";
|
|
15
15
|
import"./index-trffs83s.js";
|
|
16
|
-
import"./index-
|
|
17
|
-
import"./index-
|
|
16
|
+
import"./index-c8kj74zz.js";
|
|
17
|
+
import"./index-bma8tmgb.js";
|
|
18
18
|
import {
|
|
19
19
|
PrimitiveScript
|
|
20
|
-
} from "./index-
|
|
21
|
-
import"./index-
|
|
20
|
+
} from "./index-mvdmb73w.js";
|
|
21
|
+
import"./index-ay4vkwr8.js";
|
|
22
22
|
|
|
23
23
|
// pkgs/@akanjs/cli/primitive/primitive.command.ts
|
|
24
24
|
import { Logger } from "akanjs/common";
|
|
@@ -3,35 +3,36 @@ import {
|
|
|
3
3
|
Workspace,
|
|
4
4
|
script,
|
|
5
5
|
command
|
|
6
|
-
} from "./index-
|
|
6
|
+
} from "./index-mv3ke0fc.js";
|
|
7
7
|
import"./index-j4yvgfhr.js";
|
|
8
|
-
import"./index-
|
|
8
|
+
import"./index-ys1sjp6m.js";
|
|
9
9
|
import"./index-zyjztrvc.js";
|
|
10
10
|
import {
|
|
11
11
|
AppExecutor2
|
|
12
|
-
} from "./index-
|
|
12
|
+
} from "./index-77627y32.js";
|
|
13
13
|
import {
|
|
14
14
|
LibExecutor2
|
|
15
|
-
} from "./index-
|
|
15
|
+
} from "./index-741xbhes.js";
|
|
16
16
|
import {
|
|
17
17
|
PkgExecutor2
|
|
18
|
-
} from "./index-
|
|
18
|
+
} from "./index-wzvvqkcy.js";
|
|
19
19
|
import {
|
|
20
20
|
MaintainabilityBaseline
|
|
21
|
-
} from "./index-
|
|
21
|
+
} from "./index-54g085ty.js";
|
|
22
22
|
import {
|
|
23
23
|
WorkspaceRunner,
|
|
24
24
|
AkanQualityScanner,
|
|
25
25
|
formatQualityScanResult,
|
|
26
26
|
formatSsrScanResult
|
|
27
|
-
} from "./index-
|
|
27
|
+
} from "./index-aezpcphy.js";
|
|
28
28
|
import"./index-trffs83s.js";
|
|
29
29
|
import"./index-1p81ecbz.js";
|
|
30
30
|
import"./index-62md4dwy.js";
|
|
31
|
+
import"./index-35p43f33.js";
|
|
31
32
|
import"./index-zyb0ebm4.js";
|
|
32
33
|
import"./index-jf4vk1s0.js";
|
|
33
34
|
import"./index-t4d0ckde.js";
|
|
34
|
-
import"./index-
|
|
35
|
+
import"./index-ay4vkwr8.js";
|
|
35
36
|
|
|
36
37
|
// pkgs/@akanjs/cli/quality/quality.script.ts
|
|
37
38
|
import { Logger } from "akanjs/common";
|
|
@@ -3,21 +3,21 @@ import {
|
|
|
3
3
|
Workspace,
|
|
4
4
|
script,
|
|
5
5
|
command
|
|
6
|
-
} from "./index-
|
|
6
|
+
} from "./index-mv3ke0fc.js";
|
|
7
7
|
import"./index-j4yvgfhr.js";
|
|
8
|
-
import"./index-
|
|
8
|
+
import"./index-ys1sjp6m.js";
|
|
9
9
|
import"./index-zyjztrvc.js";
|
|
10
|
-
import"./index-
|
|
11
|
-
import"./index-
|
|
12
|
-
import"./index-
|
|
13
|
-
import"./index-
|
|
10
|
+
import"./index-77627y32.js";
|
|
11
|
+
import"./index-741xbhes.js";
|
|
12
|
+
import"./index-wzvvqkcy.js";
|
|
13
|
+
import"./index-0zkxsdsg.js";
|
|
14
14
|
import"./index-trffs83s.js";
|
|
15
|
-
import"./index-
|
|
15
|
+
import"./index-6a3rmwxx.js";
|
|
16
16
|
import"./index-1p81ecbz.js";
|
|
17
17
|
import {
|
|
18
18
|
RepairRunner
|
|
19
|
-
} from "./index-
|
|
20
|
-
import"./index-
|
|
19
|
+
} from "./index-shjjjdte.js";
|
|
20
|
+
import"./index-ay4vkwr8.js";
|
|
21
21
|
|
|
22
22
|
// pkgs/@akanjs/cli/repair/repair.script.ts
|
|
23
23
|
import { Logger } from "akanjs/common";
|
|
@@ -2,21 +2,21 @@
|
|
|
2
2
|
import {
|
|
3
3
|
Sys,
|
|
4
4
|
command
|
|
5
|
-
} from "./index-
|
|
5
|
+
} from "./index-mv3ke0fc.js";
|
|
6
6
|
import"./index-j4yvgfhr.js";
|
|
7
|
-
import"./index-
|
|
7
|
+
import"./index-ys1sjp6m.js";
|
|
8
8
|
import"./index-zyjztrvc.js";
|
|
9
|
-
import"./index-
|
|
10
|
-
import"./index-
|
|
11
|
-
import"./index-
|
|
9
|
+
import"./index-77627y32.js";
|
|
10
|
+
import"./index-741xbhes.js";
|
|
11
|
+
import"./index-wzvvqkcy.js";
|
|
12
12
|
import {
|
|
13
13
|
renderPrimitiveReport
|
|
14
|
-
} from "./index-
|
|
14
|
+
} from "./index-0zkxsdsg.js";
|
|
15
15
|
import"./index-trffs83s.js";
|
|
16
16
|
import {
|
|
17
17
|
ScalarScript
|
|
18
|
-
} from "./index-
|
|
19
|
-
import"./index-
|
|
18
|
+
} from "./index-3q7ectss.js";
|
|
19
|
+
import"./index-ay4vkwr8.js";
|
|
20
20
|
|
|
21
21
|
// pkgs/@akanjs/cli/scalar/scalar.command.ts
|
|
22
22
|
import { Logger, lowerlize } from "akanjs/common";
|
package/skills/akan-err/SKILL.md
CHANGED
|
@@ -30,10 +30,19 @@ import path at all**, so keep throwing code out of them entirely rather than rea
|
|
|
30
30
|
|
|
31
31
|
Best-effort code returns a sentinel (`null`, `undefined`, `{}`) instead of throwing. `try/catch` is rare and
|
|
32
32
|
always converts an exception into a decision: a guard catches, warns, and returns `false`; an adapter
|
|
33
|
-
catches, logs, and returns `null
|
|
34
|
-
the store's `static silent` when no screen waits on it
|
|
33
|
+
catches, logs (`logger.error`), and returns `null`; a UI `try/finally` resets a spinner. A store action never
|
|
34
|
+
catches — let the framework toast the `Err`, or list it in the store's `static silent` when no screen waits on it
|
|
35
|
+
and its caller handles the rejection.
|
|
35
36
|
Client-side validation failure is `msg.error("<key>")` plus an early return, never a throw.
|
|
36
37
|
|
|
38
|
+
An `srvkit/` adapter belongs to no module: its keys go in the app's or lib's own service dictionary,
|
|
39
|
+
`lib/_<name>/<name>.dictionary.ts`, thrown as `new Err("<name>.error.<key>")` with `Err` from `"../lib/dict"`.
|
|
40
|
+
|
|
41
|
+
**An endpoint names the errors it throws on purpose** — `errors: { 409: ["ticket.error.locked"] }` in its signal
|
|
42
|
+
option, with keys its dictionary defines and never `base.error.*`. That is the status's OpenAPI response and a line
|
|
43
|
+
of the MCP tool's description; outside production a thrown key it leaves out warns once. A caller narrows with
|
|
44
|
+
`Err.is(error, "ticket.error.locked")`.
|
|
45
|
+
|
|
37
46
|
**A failure another process reported travels as itself.** A server-to-server `fetch.<endpoint>(…, { origin })`
|
|
38
47
|
restores the remote `Err` with its class, key and data. Rethrow it as-is — wrapping it in a `new Error`
|
|
39
48
|
discards what the endpoint chose to say, and a bare `Error` is generalized to "Internal Server Error" on the
|
|
@@ -33,19 +33,13 @@ export default page()
|
|
|
33
33
|
dropped. `lang` reaches every stage and is never declared.
|
|
34
34
|
3. Gate with `.guard(() => signedIn())` on the `_layout.tsx`, and repeat a stricter guard on a page that needs more.
|
|
35
35
|
`.guard((_, { path }) => signedIn({ path }))` sends a refused visitor to `/signin?redirect=<path>`.
|
|
36
|
-
4. In `.render()`: `usePage()`, then fetch, then return.
|
|
37
|
-
|
|
38
|
-
5. `.head()` takes JSX (or a function returning it), never a metadata object.
|
|
39
|
-
6. Re-skin an `akanjs/ui` component for a subtree with `_overrides.tsx`:
|
|
36
|
+
4. In `.render()`: `usePage()`, then fetch, then return.
|
|
37
|
+
5. Re-skin an `akanjs/ui` component for a subtree with `_overrides.tsx`:
|
|
40
38
|
`export default override({ Slot: AppComponent })`, no logic. Nested ones merge slot by slot, the closest winning;
|
|
41
39
|
`componentRule` lists the slots.
|
|
42
40
|
|
|
43
41
|
## API at a glance
|
|
44
42
|
|
|
45
|
-
`page`, `layout` and `router` come from `akanjs/client`, `Link` from `akanjs/ui`, `usePageLocation` from
|
|
46
|
-
`akanjs/webkit`, and `fetch`, `usePage` and the model namespaces from `@apps/<app>/client`. A stage receives the
|
|
47
|
-
declared params and search keys plus `lang`.
|
|
48
|
-
|
|
49
43
|
- Data-driven title: `.head(async ({ id }) => <title>{((await fetch.book(id)) as Book | null)?.title}</title>)`,
|
|
50
44
|
where `Book` is the `common/` interface for the query's `Any` return (`akan-service`).
|
|
51
45
|
- Async page: `.render(async ({ id }) => { const book = (await fetch.book(id)) as Book | null; if (!book) return router.notFound(); … })`;
|
|
@@ -65,12 +59,8 @@ declared params and search keys plus `lang`.
|
|
|
65
59
|
scrollToTop: false })`` in a `"use client"` component, read back with `usePageLocation().searchParams`. Shallow
|
|
66
60
|
holds only while the path stays the same; a server `.search()` sees the value at the next full navigation.
|
|
67
61
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
- A `fetch.<mutation>()` while rendering — it throws `base.error.mutationInRender`, because opening a link would
|
|
71
|
-
perform it. Send writes from a user action.
|
|
72
|
-
- `useState`, `useEffect`, comments, a named export beside the chain, or the legacy `export default async function`.
|
|
73
|
-
- Editing a lib page through its link in `page/(libs)/` — edit the lib's own `page/` source.
|
|
62
|
+
What a route file must never do — write while rendering, hooks, a second export — is the `page` rule, loaded with
|
|
63
|
+
any `page/` file.
|
|
74
64
|
|
|
75
65
|
Full detail: `get_guideline` with `pageRule` (guards in depth, heads, MCP apps, CSR root layouts, lib pages), or
|
|
76
66
|
`ssrRule` for what may render on the server. Every stage's signature, the router's methods, Link's props and every
|
|
@@ -18,6 +18,7 @@ the agent guide's Path Rules table.
|
|
|
18
18
|
| The production image | `docker: string \| { image, preRuns, postRuns, command }` |
|
|
19
19
|
| iOS, Android, desktop | the `native` section; `desktop: { server: true }` carries the server |
|
|
20
20
|
| SQLite, several databases, a cluster | `database: { modes: [...] }` (`single`, `multiple`, `cluster`), picked by `AKAN_DATABASE_MODE` |
|
|
21
|
+
| A secret of `env/env.server.<env>.ts` in a deployed server | nothing to declare: `akan build` leaves it out and the server reads it from a variable named after its key path; `akan secret-env <app> --env <env>` lists them |
|
|
21
22
|
| URLs without `/<locale>/`: one language, or paths fixed from outside (OAuth callback, QR code, mail link) | `i18n: { localePrefix: "as-needed" }` — the default locale's pages and `<Link>` hrefs drop the prefix, other locales keep it |
|
|
22
23
|
|
|
23
24
|
## Running and logs
|
|
@@ -28,6 +29,25 @@ the agent guide's Path Rules table.
|
|
|
28
29
|
- Run a build without Docker with `cd dist/apps/<app> && bun main.js`: it boots with the env the Dockerfile sets,
|
|
29
30
|
read from `akan.env.json` beside it, and a variable you set yourself (`PORT=3000`) wins.
|
|
30
31
|
|
|
32
|
+
## Secrets in a deployed server
|
|
33
|
+
|
|
34
|
+
- Write secrets in `env/env.server.<env>.ts` as before. `akan build` replaces each string under a secret-named key,
|
|
35
|
+
and each URL carrying a password, with a read of an environment variable: `security.sso.google.clientSecret` is
|
|
36
|
+
`SECURITY__SSO__GOOGLE__CLIENT_SECRET`, an array holding a secret is one JSON variable, `security.jwtSecret` is
|
|
37
|
+
`JWT_SECRET`. The built files hold the names (`AKAN_ENV_NAMES` in `akan.env.json`), never the values.
|
|
38
|
+
- `akan secret-env <app> --env <env>` prints the variables, never a value. `--out <file> --format k8s --name <name>`
|
|
39
|
+
writes a Kubernetes Secret for `envFrom`, `--format dotenv` a file for `bun --env-file`. Never write it
|
|
40
|
+
under `dist/` or a tracked path, and delete it once applied.
|
|
41
|
+
- At boot a variable left unset is one warning naming it. The framework does not stop for it, though whatever reads the value may; 3.5.0 will refuse to boot.
|
|
42
|
+
- A secret the env file computes or imports stops the build, whatever its length: write the string at the key, or
|
|
43
|
+
`process.env.<NAME>` there, which the build leaves as that read. A secret string a plain key or the app's code
|
|
44
|
+
holds as well stops it too when long and mixed, and is a warning when short. A key the name rule misses
|
|
45
|
+
(`stripeKey`) stays in the image unless read from `process.env`.
|
|
46
|
+
- The build loads the env file to list the secrets, with the shell's variables only when it cannot load without
|
|
47
|
+
them; a file that throws as it loads stops the build by error class and line.
|
|
48
|
+
- `akan start`, `akan test`, `akan build --profile …` and desktop and mobile builds read the env file as written.
|
|
49
|
+
`akan build --inline-secrets` keeps the values in the image for one release, for a deployment not ready yet.
|
|
50
|
+
|
|
31
51
|
## Native and desktop
|
|
32
52
|
|
|
33
53
|
A `start-*` command loads its pages from a running `akan start`; a desktop app carrying its server starts it itself.
|
|
@@ -5,33 +5,33 @@ import {
|
|
|
5
5
|
runner,
|
|
6
6
|
script,
|
|
7
7
|
command
|
|
8
|
-
} from "./index-
|
|
8
|
+
} from "./index-mv3ke0fc.js";
|
|
9
9
|
import"./index-j4yvgfhr.js";
|
|
10
10
|
import {
|
|
11
11
|
Executor,
|
|
12
12
|
LibSource,
|
|
13
13
|
WorkspaceExecutor
|
|
14
|
-
} from "./index-
|
|
14
|
+
} from "./index-ys1sjp6m.js";
|
|
15
15
|
import {
|
|
16
16
|
FileSys2
|
|
17
17
|
} from "./index-zyjztrvc.js";
|
|
18
18
|
import {
|
|
19
19
|
AppExecutor2
|
|
20
|
-
} from "./index-
|
|
21
|
-
import"./index-
|
|
22
|
-
import"./index-
|
|
20
|
+
} from "./index-77627y32.js";
|
|
21
|
+
import"./index-741xbhes.js";
|
|
22
|
+
import"./index-wzvvqkcy.js";
|
|
23
23
|
import {
|
|
24
24
|
GlobalConfig
|
|
25
|
-
} from "./index-
|
|
25
|
+
} from "./index-extg77rx.js";
|
|
26
26
|
import"./index-m9jj544v.js";
|
|
27
|
-
import"./index-
|
|
27
|
+
import"./index-es2wkn41.js";
|
|
28
28
|
import {
|
|
29
29
|
SubspaceConfig
|
|
30
30
|
} from "./index-xczjdng6.js";
|
|
31
31
|
import {
|
|
32
32
|
SlicePlanner
|
|
33
|
-
} from "./index-
|
|
34
|
-
import"./index-
|
|
33
|
+
} from "./index-5sa1tr7w.js";
|
|
34
|
+
import"./index-ay4vkwr8.js";
|
|
35
35
|
|
|
36
36
|
// pkgs/@akanjs/devkit/subspace/subspace.ts
|
|
37
37
|
import { mkdir as mkdir2 } from "fs/promises";
|
|
@@ -822,7 +822,7 @@ class SubspaceRunner extends runner("subspace") {
|
|
|
822
822
|
if (!asked)
|
|
823
823
|
return { name: subspace.name, workspaceId, host, apps, libs: [], outcome: "cancelled", files: [] };
|
|
824
824
|
const { libs } = await subspace.slice();
|
|
825
|
-
const { CloudScript } = await import("./cloud.script-
|
|
825
|
+
const { CloudScript } = await import("./cloud.script-34xmprty.js");
|
|
826
826
|
const { files } = await CommandContainer.get(CloudScript).uploadEnv(workspace, {
|
|
827
827
|
host,
|
|
828
828
|
workspaceId,
|
|
@@ -4,28 +4,28 @@ import {
|
|
|
4
4
|
runner,
|
|
5
5
|
script,
|
|
6
6
|
command
|
|
7
|
-
} from "./index-
|
|
7
|
+
} from "./index-mv3ke0fc.js";
|
|
8
8
|
import"./index-j4yvgfhr.js";
|
|
9
|
-
import"./index-
|
|
9
|
+
import"./index-ys1sjp6m.js";
|
|
10
10
|
import"./index-zyjztrvc.js";
|
|
11
11
|
import {
|
|
12
12
|
AppExecutor2
|
|
13
|
-
} from "./index-
|
|
14
|
-
import"./index-
|
|
15
|
-
import"./index-
|
|
13
|
+
} from "./index-77627y32.js";
|
|
14
|
+
import"./index-741xbhes.js";
|
|
15
|
+
import"./index-wzvvqkcy.js";
|
|
16
16
|
import {
|
|
17
17
|
GlobalConfig,
|
|
18
18
|
CloudApi
|
|
19
|
-
} from "./index-
|
|
19
|
+
} from "./index-extg77rx.js";
|
|
20
20
|
import"./index-m9jj544v.js";
|
|
21
|
-
import"./index-
|
|
21
|
+
import"./index-es2wkn41.js";
|
|
22
22
|
import {
|
|
23
23
|
TunnelShare2
|
|
24
|
-
} from "./index-
|
|
24
|
+
} from "./index-hxcefw29.js";
|
|
25
25
|
import {
|
|
26
26
|
writeClipboard
|
|
27
27
|
} from "./index-p6pbz9n5.js";
|
|
28
|
-
import"./index-
|
|
28
|
+
import"./index-ay4vkwr8.js";
|
|
29
29
|
|
|
30
30
|
// pkgs/@akanjs/cli/tunnel/tunnel.script.ts
|
|
31
31
|
import { select } from "@inquirer/prompts";
|
package/typecheck.proc.js
CHANGED
|
@@ -4,39 +4,40 @@ import {
|
|
|
4
4
|
script,
|
|
5
5
|
markCliErrorPrinted,
|
|
6
6
|
command
|
|
7
|
-
} from "./index-
|
|
7
|
+
} from "./index-mv3ke0fc.js";
|
|
8
8
|
import {
|
|
9
9
|
CliError
|
|
10
10
|
} from "./index-j4yvgfhr.js";
|
|
11
|
-
import"./index-
|
|
11
|
+
import"./index-ys1sjp6m.js";
|
|
12
12
|
import"./index-zyjztrvc.js";
|
|
13
|
-
import"./index-
|
|
14
|
-
import"./index-
|
|
15
|
-
import"./index-
|
|
13
|
+
import"./index-77627y32.js";
|
|
14
|
+
import"./index-741xbhes.js";
|
|
15
|
+
import"./index-wzvvqkcy.js";
|
|
16
16
|
import {
|
|
17
17
|
ApplicationRunner,
|
|
18
18
|
VerifyScope
|
|
19
|
-
} from "./index-
|
|
20
|
-
import"./index-
|
|
21
|
-
import"./index-
|
|
22
|
-
import"./index-
|
|
19
|
+
} from "./index-th7qbjfz.js";
|
|
20
|
+
import"./index-serpfvat.js";
|
|
21
|
+
import"./index-es2wkn41.js";
|
|
22
|
+
import"./index-gdgbgn82.js";
|
|
23
23
|
import"./index-m9jj544v.js";
|
|
24
24
|
import"./index-1p81ecbz.js";
|
|
25
25
|
import"./index-62md4dwy.js";
|
|
26
|
+
import"./index-35p43f33.js";
|
|
26
27
|
import"./index-zyb0ebm4.js";
|
|
27
28
|
import {
|
|
28
29
|
WorkspaceRunner
|
|
29
|
-
} from "./index-
|
|
30
|
-
import"./index-
|
|
30
|
+
} from "./index-aezpcphy.js";
|
|
31
|
+
import"./index-54g085ty.js";
|
|
31
32
|
import"./index-trffs83s.js";
|
|
32
33
|
import"./index-jf4vk1s0.js";
|
|
33
34
|
import"./index-t4d0ckde.js";
|
|
34
35
|
import {
|
|
35
36
|
VerifyPipeline,
|
|
36
37
|
VerifyReport
|
|
37
|
-
} from "./index-
|
|
38
|
-
import"./index-
|
|
39
|
-
import"./index-
|
|
38
|
+
} from "./index-1c52g4st.js";
|
|
39
|
+
import"./index-5sa1tr7w.js";
|
|
40
|
+
import"./index-ay4vkwr8.js";
|
|
40
41
|
|
|
41
42
|
// pkgs/@akanjs/cli/verify/verify.script.ts
|
|
42
43
|
import path from "path";
|
|
@@ -3,33 +3,33 @@ import {
|
|
|
3
3
|
Workspace,
|
|
4
4
|
script,
|
|
5
5
|
command
|
|
6
|
-
} from "./index-
|
|
6
|
+
} from "./index-mv3ke0fc.js";
|
|
7
7
|
import"./index-j4yvgfhr.js";
|
|
8
|
-
import"./index-
|
|
8
|
+
import"./index-ys1sjp6m.js";
|
|
9
9
|
import"./index-zyjztrvc.js";
|
|
10
|
-
import"./index-
|
|
11
|
-
import"./index-
|
|
12
|
-
import"./index-
|
|
10
|
+
import"./index-77627y32.js";
|
|
11
|
+
import"./index-741xbhes.js";
|
|
12
|
+
import"./index-wzvvqkcy.js";
|
|
13
13
|
import {
|
|
14
14
|
jsonText,
|
|
15
15
|
workflowStatus,
|
|
16
16
|
renderWorkflowPlan,
|
|
17
17
|
renderWorkflowApply,
|
|
18
18
|
renderWorkflowValidation
|
|
19
|
-
} from "./index-
|
|
19
|
+
} from "./index-0zkxsdsg.js";
|
|
20
20
|
import"./index-trffs83s.js";
|
|
21
|
-
import"./index-
|
|
21
|
+
import"./index-6a3rmwxx.js";
|
|
22
22
|
import"./index-1p81ecbz.js";
|
|
23
|
-
import"./index-
|
|
24
|
-
import"./index-
|
|
25
|
-
import"./index-
|
|
26
|
-
import"./index-
|
|
27
|
-
import"./index-
|
|
23
|
+
import"./index-c8kj74zz.js";
|
|
24
|
+
import"./index-bma8tmgb.js";
|
|
25
|
+
import"./index-mvdmb73w.js";
|
|
26
|
+
import"./index-shjjjdte.js";
|
|
27
|
+
import"./index-3q7ectss.js";
|
|
28
28
|
import"./index-t4d0ckde.js";
|
|
29
29
|
import {
|
|
30
30
|
WorkflowRunner
|
|
31
|
-
} from "./index-
|
|
32
|
-
import"./index-
|
|
31
|
+
} from "./index-psvxwemh.js";
|
|
32
|
+
import"./index-ay4vkwr8.js";
|
|
33
33
|
|
|
34
34
|
// pkgs/@akanjs/cli/workflow/workflow.script.ts
|
|
35
35
|
import { Logger } from "akanjs/common";
|