@lunora/cli 0.0.0 → 1.0.0-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/LICENSE.md +105 -0
  2. package/README.md +109 -9
  3. package/__assets__/package-og.svg +14 -0
  4. package/dist/bin.mjs +11 -0
  5. package/dist/index.d.mts +852 -0
  6. package/dist/index.d.ts +852 -0
  7. package/dist/index.mjs +19 -0
  8. package/dist/packem_chunks/handler.mjs +76 -0
  9. package/dist/packem_chunks/handler10.mjs +22 -0
  10. package/dist/packem_chunks/handler11.mjs +192 -0
  11. package/dist/packem_chunks/handler12.mjs +131 -0
  12. package/dist/packem_chunks/handler13.mjs +65 -0
  13. package/dist/packem_chunks/handler14.mjs +58 -0
  14. package/dist/packem_chunks/handler15.mjs +79 -0
  15. package/dist/packem_chunks/handler16.mjs +41 -0
  16. package/dist/packem_chunks/handler17.mjs +105 -0
  17. package/dist/packem_chunks/handler18.mjs +172 -0
  18. package/dist/packem_chunks/handler19.mjs +89 -0
  19. package/dist/packem_chunks/handler2.mjs +114 -0
  20. package/dist/packem_chunks/handler20.mjs +94 -0
  21. package/dist/packem_chunks/handler21.mjs +311 -0
  22. package/dist/packem_chunks/handler3.mjs +204 -0
  23. package/dist/packem_chunks/handler4.mjs +33 -0
  24. package/dist/packem_chunks/handler5.mjs +49 -0
  25. package/dist/packem_chunks/handler6.mjs +91 -0
  26. package/dist/packem_chunks/handler7.mjs +42 -0
  27. package/dist/packem_chunks/handler8.mjs +174 -0
  28. package/dist/packem_chunks/handler9.mjs +16 -0
  29. package/dist/packem_chunks/planDevCommand.mjs +543 -0
  30. package/dist/packem_chunks/runCodegenCommand.mjs +52 -0
  31. package/dist/packem_chunks/runDeployCommand.mjs +504 -0
  32. package/dist/packem_chunks/runInitCommand.mjs +652 -0
  33. package/dist/packem_chunks/runMigrateGenerateCommand.mjs +397 -0
  34. package/dist/packem_chunks/runResetCommand.mjs +41 -0
  35. package/dist/packem_chunks/runRpcCommand.mjs +68 -0
  36. package/dist/packem_shared/COMMANDS-1V_KEx35.mjs +905 -0
  37. package/dist/packem_shared/DEFAULT_IMPORT_BATCH_SIZE-Ck-2bU08.mjs +244 -0
  38. package/dist/packem_shared/admin-url-4UzT-CI4.mjs +19 -0
  39. package/dist/packem_shared/api-spec-CtA6ilu4.mjs +13 -0
  40. package/dist/packem_shared/buildRegistryIndex-BcYe607_.mjs +38 -0
  41. package/dist/packem_shared/command-BDXcJCCJ.mjs +14 -0
  42. package/dist/packem_shared/createLogger-CHPNjFw2.mjs +73 -0
  43. package/dist/packem_shared/defaultSpawner-DxI3mebw.mjs +43 -0
  44. package/dist/packem_shared/diffSnapshots-RR2ZE8Ya.mjs +161 -0
  45. package/dist/packem_shared/docker-hMQ97KSQ.mjs +21 -0
  46. package/dist/packem_shared/features-ocSSpZtS.mjs +24 -0
  47. package/dist/packem_shared/insertSchemaExtension-BuzF6-t2.mjs +59 -0
  48. package/dist/packem_shared/open-url-Dfq6fAyT.mjs +41 -0
  49. package/dist/packem_shared/output-format-7gyGR3h8.mjs +17 -0
  50. package/dist/packem_shared/parseArgs-YXFuKdEk.mjs +56 -0
  51. package/dist/packem_shared/parseManifest--vZf2FY1.mjs +94 -0
  52. package/dist/packem_shared/resolve-target-qbsJ_5sF.mjs +16 -0
  53. package/dist/packem_shared/runAddCommand-BZGkRnBs.mjs +693 -0
  54. package/dist/packem_shared/schema-drift-gate-BtBt0as0.mjs +79 -0
  55. package/dist/packem_shared/schemaIrToSnapshot-aBTo7TM5.mjs +43 -0
  56. package/dist/packem_shared/wrangler-name-cy4yhm9j.mjs +12 -0
  57. package/package.json +61 -18
  58. package/skills/README.md +29 -0
  59. package/skills/lunora/SKILL.md +83 -0
  60. package/skills/lunora-create-package/SKILL.md +129 -0
  61. package/skills/lunora-deploy/SKILL.md +150 -0
  62. package/skills/lunora-functions/SKILL.md +182 -0
  63. package/skills/lunora-migration-helper/SKILL.md +194 -0
  64. package/skills/lunora-performance-audit/SKILL.md +143 -0
  65. package/skills/lunora-quickstart/SKILL.md +240 -0
  66. package/skills/lunora-realtime/SKILL.md +177 -0
  67. package/skills/lunora-setup-auth/SKILL.md +170 -0
  68. package/skills/lunora-setup-hyperdrive/SKILL.md +154 -0
  69. package/skills/lunora-setup-hyperdrive-global/SKILL.md +171 -0
  70. package/skills/lunora-setup-mail/SKILL.md +151 -0
  71. package/skills/lunora-setup-scheduler/SKILL.md +157 -0
  72. package/skills/lunora-setup-storage/SKILL.md +154 -0
package/dist/index.mjs ADDED
@@ -0,0 +1,19 @@
1
+ export { COMMANDS, VERSION, runCli } from './packem_shared/COMMANDS-1V_KEx35.mjs';
2
+ export { runCodegenCommand } from './packem_chunks/runCodegenCommand.mjs';
3
+ export { DEFAULT_IMPORT_BATCH_SIZE, runExportCommand, runImportCommand } from './packem_shared/DEFAULT_IMPORT_BATCH_SIZE-Ck-2bU08.mjs';
4
+ export { runDeployCommand } from './packem_chunks/runDeployCommand.mjs';
5
+ export { planDevCommand, runDevCommand } from './packem_chunks/planDevCommand.mjs';
6
+ export { runInitCommand } from './packem_chunks/runInitCommand.mjs';
7
+ export { runMigrateGenerateCommand } from './packem_chunks/runMigrateGenerateCommand.mjs';
8
+ export { runResetCommand } from './packem_chunks/runResetCommand.mjs';
9
+ export { runRpcCommand } from './packem_chunks/runRpcCommand.mjs';
10
+ export { default as parseArgs } from './packem_shared/parseArgs-YXFuKdEk.mjs';
11
+ export { insertSchemaExtension } from './packem_shared/insertSchemaExtension-BuzF6-t2.mjs';
12
+ export { createLogger, pail } from './packem_shared/createLogger-CHPNjFw2.mjs';
13
+ export { diffSnapshots, renderAddColumn, renderCreateIndex, renderCreateTable, renderDropIndex, renderDropTable, renderMigrationFile, validatorKindToSqlType } from './packem_shared/diffSnapshots-RR2ZE8Ya.mjs';
14
+ export { default as schemaIrToSnapshot } from './packem_shared/schemaIrToSnapshot-aBTo7TM5.mjs';
15
+ export { createRecordingSpawner, defaultSpawner } from './packem_shared/defaultSpawner-DxI3mebw.mjs';
16
+ export { default as parseManifest } from './packem_shared/parseManifest--vZf2FY1.mjs';
17
+ export { REQUIRED_COMPATIBILITY_DATE, REQUIRED_FLAG, validateWranglerProject as validateWrangler, validateWranglerConfig } from '@lunora/config';
18
+ export { buildRegistryIndex } from './packem_shared/buildRegistryIndex-BcYe607_.mjs';
19
+ export { runAddCommand, runBuildIndexCommand, runRegistryViewCommand } from './packem_shared/runAddCommand-BZGkRnBs.mjs';
@@ -0,0 +1,76 @@
1
+ import { existsSync } from 'node:fs';
2
+ import { findWranglerFile, promptSelect } from '@lunora/config';
3
+ import { join } from '@visulima/path';
4
+ import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
5
+ import { n as normalizeFeature, E as EMAIL_ITEM, D as DEFAULT_AUTH_ITEM, p as promptAuthProvider, A as AUTH_PROVIDER_OPTIONS } from '../packem_shared/features-ocSSpZtS.mjs';
6
+ import { runAddCommand } from '../packem_shared/runAddCommand-BZGkRnBs.mjs';
7
+
8
+ const providerToItem = (provider) => {
9
+ const value = provider.trim().toLowerCase();
10
+ const match = AUTH_PROVIDER_OPTIONS.find(
11
+ (option) => option.value === value || option.label.toLowerCase() === value || value === "auth0" && option.value === "auth-auth0" || value === "clerk" && option.value === "auth-clerk"
12
+ );
13
+ return match?.value;
14
+ };
15
+ const resolveAuthItem = async (options) => {
16
+ if (options.provider !== void 0 && options.provider !== "") {
17
+ const item = providerToItem(options.provider);
18
+ if (item === void 0) {
19
+ options.logger.warn(`add: unknown --provider "${options.provider}" — using "${DEFAULT_AUTH_ITEM}" (email & password).`);
20
+ return DEFAULT_AUTH_ITEM;
21
+ }
22
+ return item;
23
+ }
24
+ if (options.yes === true) {
25
+ return DEFAULT_AUTH_ITEM;
26
+ }
27
+ const select = options.promptSelect ?? ((message, choices, settings) => promptSelect(message, choices, settings));
28
+ return promptAuthProvider(select);
29
+ };
30
+ const resolveFeatureItems = async (feature, options) => {
31
+ if (feature.kind === "auth") {
32
+ return [await resolveAuthItem(options)];
33
+ }
34
+ if (feature.kind === "email") {
35
+ return [EMAIL_ITEM];
36
+ }
37
+ return [feature.item];
38
+ };
39
+ const runAddFeature = async (options) => {
40
+ const cwd = options.cwd ?? process.cwd();
41
+ const feature = options.feature === void 0 ? void 0 : normalizeFeature(options.feature);
42
+ if (feature === void 0) {
43
+ options.logger.error("add requires a feature or registry item. Usage: lunora add <auth|email|storage|crons|presence|…>");
44
+ return { code: 1, items: [] };
45
+ }
46
+ if (!existsSync(join(cwd, "lunora")) || findWranglerFile(cwd) === void 0) {
47
+ options.logger.error("add: not a Lunora project here (need a lunora/ directory and a wrangler.jsonc). Run `lunora init` first.");
48
+ return { code: 1, items: [] };
49
+ }
50
+ const items = await resolveFeatureItems(feature, options);
51
+ const result = await runAddCommand({
52
+ allowUnsafeSource: options.allowUnsafeSource,
53
+ cwd,
54
+ from: options.from,
55
+ logger: options.logger,
56
+ names: [...items],
57
+ source: options.source,
58
+ yes: true
59
+ });
60
+ return { code: result.code, items };
61
+ };
62
+ const execute = defineHandler(async ({ argument, cwd, logger, options }) => {
63
+ const result = await runAddFeature({
64
+ allowUnsafeSource: options.allowUnsafeSource === true,
65
+ cwd,
66
+ feature: argument[0],
67
+ from: options.from,
68
+ logger,
69
+ provider: options.provider,
70
+ source: options.source,
71
+ yes: options.yes === true
72
+ });
73
+ return { code: result.code };
74
+ });
75
+
76
+ export { execute, runAddFeature };
@@ -0,0 +1,22 @@
1
+ import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
2
+ import { a as resolveProductionWorkerUrl } from '../packem_shared/resolve-target-qbsJ_5sF.mjs';
3
+ import { runImportCommand } from '../packem_shared/DEFAULT_IMPORT_BATCH_SIZE-Ck-2bU08.mjs';
4
+
5
+ const execute = defineHandler(({ argument, cwd, logger, options }) => {
6
+ const file = argument[0];
7
+ if (!file) {
8
+ logger.error("import requires a file. Usage: lunora import <path> [--table <name>]");
9
+ return { code: 1 };
10
+ }
11
+ return runImportCommand({
12
+ batchSize: options.batchSize,
13
+ file,
14
+ logger,
15
+ prod: options.prod === true,
16
+ table: options.table,
17
+ token: options.token,
18
+ url: resolveProductionWorkerUrl({ cwd, prod: options.prod === true, url: options.url })
19
+ });
20
+ });
21
+
22
+ export { execute };
@@ -0,0 +1,192 @@
1
+ import { readFileSync, existsSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { discoverSchema } from '@lunora/codegen';
4
+ import { readLinkedProject } from '@lunora/config';
5
+ import { parse } from 'jsonc-parser';
6
+ import { Project } from 'ts-morph';
7
+ import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
8
+
9
+ const findWranglerFile = (projectRoot) => {
10
+ for (const candidate of ["wrangler.jsonc", "wrangler.json"]) {
11
+ const fullPath = join(projectRoot, candidate);
12
+ if (existsSync(fullPath)) {
13
+ return fullPath;
14
+ }
15
+ }
16
+ return void 0;
17
+ };
18
+ const stringField = (record, key) => {
19
+ if (record === null || typeof record !== "object") {
20
+ return void 0;
21
+ }
22
+ const value = record[key];
23
+ return typeof value === "string" && value.length > 0 ? value : void 0;
24
+ };
25
+ const arrayField = (record, key) => {
26
+ if (record === null || typeof record !== "object") {
27
+ return [];
28
+ }
29
+ const value = record[key];
30
+ return Array.isArray(value) ? value : [];
31
+ };
32
+ const summariseWrangler = (raw) => {
33
+ const durableObjectBindings = arrayField(raw.durable_objects ?? {}, "bindings");
34
+ const d1 = arrayField(raw, "d1_databases");
35
+ const vectorize = arrayField(raw, "vectorize");
36
+ return {
37
+ bindings: {
38
+ d1: d1.map((entry) => stringField(entry, "binding") ?? "<unnamed>"),
39
+ durableObjects: durableObjectBindings.map((entry) => stringField(entry, "name") ?? "<unnamed>"),
40
+ vectorize: vectorize.map((entry) => stringField(entry, "binding") ?? "<unnamed>")
41
+ },
42
+ compatibilityDate: stringField(raw, "compatibility_date"),
43
+ compatibilityFlags: arrayField(raw, "compatibility_flags").filter((entry) => typeof entry === "string"),
44
+ main: stringField(raw, "main"),
45
+ name: stringField(raw, "name")
46
+ };
47
+ };
48
+ const summariseSchema = (schema) => {
49
+ return {
50
+ tables: schema.tables.map((table) => {
51
+ let shard = "root";
52
+ if (table.shardMode === "global") {
53
+ shard = "global";
54
+ } else if (typeof table.shardMode === "object") {
55
+ shard = `shardBy(${table.shardMode.field})`;
56
+ }
57
+ return {
58
+ indexes: table.indexes.length,
59
+ name: table.name,
60
+ shard
61
+ };
62
+ }),
63
+ vectorIndexes: schema.vectorIndexes.length
64
+ };
65
+ };
66
+ const collectLunoraPackages = (projectRoot) => {
67
+ const pkgPath = join(projectRoot, "package.json");
68
+ if (!existsSync(pkgPath)) {
69
+ return [];
70
+ }
71
+ let pkg;
72
+ try {
73
+ pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
74
+ } catch {
75
+ return [];
76
+ }
77
+ if (pkg === null || typeof pkg !== "object") {
78
+ return [];
79
+ }
80
+ const sections = ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"];
81
+ const seen = /* @__PURE__ */ new Map();
82
+ for (const section of sections) {
83
+ const block = pkg[section];
84
+ if (block === null || typeof block !== "object") {
85
+ continue;
86
+ }
87
+ for (const [name, version] of Object.entries(block)) {
88
+ if (!name.startsWith("@lunora/")) {
89
+ continue;
90
+ }
91
+ if (typeof version === "string" && !seen.has(name)) {
92
+ seen.set(name, version);
93
+ }
94
+ }
95
+ }
96
+ return [...seen.entries()].toSorted(([a], [b]) => a.localeCompare(b)).map(([name, version]) => {
97
+ return { name, version };
98
+ });
99
+ };
100
+ const collectInfo = (projectRoot) => {
101
+ const lunoraPackages = collectLunoraPackages(projectRoot);
102
+ const wranglerPath = findWranglerFile(projectRoot);
103
+ let wrangler;
104
+ if (wranglerPath) {
105
+ try {
106
+ wrangler = summariseWrangler(parse(readFileSync(wranglerPath, "utf8")));
107
+ } catch {
108
+ wrangler = void 0;
109
+ }
110
+ }
111
+ const schemaPath = join(projectRoot, "lunora", "schema.ts");
112
+ let schema;
113
+ let schemaError;
114
+ if (existsSync(schemaPath)) {
115
+ try {
116
+ const project = new Project({ skipAddingFilesFromTsConfig: true, useInMemoryFileSystem: false });
117
+ schema = summariseSchema(discoverSchema(project, schemaPath));
118
+ } catch (error) {
119
+ schemaError = error instanceof Error ? error.message : String(error);
120
+ }
121
+ }
122
+ return {
123
+ link: readLinkedProject(projectRoot),
124
+ lunoraPackages,
125
+ projectRoot,
126
+ schema,
127
+ schemaError,
128
+ wrangler,
129
+ wranglerPath
130
+ };
131
+ };
132
+ const renderText = (snapshot, logger) => {
133
+ logger.info(`project: ${snapshot.projectRoot}`);
134
+ logger.info("");
135
+ logger.info("@lunora/* packages:");
136
+ if (snapshot.lunoraPackages.length === 0) {
137
+ logger.info(" (none found in package.json)");
138
+ } else {
139
+ for (const pkg of snapshot.lunoraPackages) {
140
+ logger.info(` ${pkg.name}@${pkg.version}`);
141
+ }
142
+ }
143
+ logger.info("");
144
+ if (snapshot.wrangler) {
145
+ logger.info(`wrangler: ${snapshot.wranglerPath ?? ""}`);
146
+ logger.info(` name: ${snapshot.wrangler.name ?? "<unset>"}`);
147
+ logger.info(` main: ${snapshot.wrangler.main ?? "<unset>"}`);
148
+ logger.info(` compatibility_date: ${snapshot.wrangler.compatibilityDate ?? "<unset>"}`);
149
+ logger.info(` compatibility_flags: ${snapshot.wrangler.compatibilityFlags.join(", ") || "<none>"}`);
150
+ logger.info(` durable objects: ${snapshot.wrangler.bindings.durableObjects.join(", ") || "<none>"}`);
151
+ logger.info(` d1 databases: ${snapshot.wrangler.bindings.d1.join(", ") || "<none>"}`);
152
+ logger.info(` vectorize indexes: ${snapshot.wrangler.bindings.vectorize.join(", ") || "<none>"}`);
153
+ } else {
154
+ logger.info("wrangler: (not found)");
155
+ }
156
+ logger.info("");
157
+ if (snapshot.link) {
158
+ logger.info(`link: ${snapshot.link.workerName ?? "(unnamed)"} -> ${snapshot.link.workerUrl ?? "<no url>"}`);
159
+ if (snapshot.link.env !== void 0) {
160
+ logger.info(` env: ${snapshot.link.env}`);
161
+ }
162
+ } else {
163
+ logger.info("link: (not linked — run `lunora link --url <https://your-worker>`)");
164
+ }
165
+ logger.info("");
166
+ if (snapshot.schemaError !== void 0) {
167
+ logger.warn(`schema: parse error — ${snapshot.schemaError}`);
168
+ } else if (snapshot.schema) {
169
+ logger.info(`schema: ${String(snapshot.schema.tables.length)} table(s), ${String(snapshot.schema.vectorIndexes)} vector index(es)`);
170
+ for (const table of snapshot.schema.tables) {
171
+ logger.info(` ${table.name} [${table.shard}, ${String(table.indexes)} index(es)]`);
172
+ }
173
+ } else {
174
+ logger.info("schema: (no lunora/schema.ts)");
175
+ }
176
+ };
177
+ const runInfoCommand = (options) => {
178
+ const cwd = options.cwd ?? process.cwd();
179
+ const snapshot = collectInfo(cwd);
180
+ if (options.json) {
181
+ process.stdout.write(`${JSON.stringify(snapshot, void 0, 2)}
182
+ `);
183
+ } else {
184
+ renderText(snapshot, options.logger);
185
+ }
186
+ return { code: 0, snapshot };
187
+ };
188
+ const execute = defineHandler(
189
+ ({ cwd, logger, options }) => runInfoCommand({ cwd, json: options.json === true, logger })
190
+ );
191
+
192
+ export { collectInfo, execute, runInfoCommand };
@@ -0,0 +1,131 @@
1
+ import { r as resolveAdminBaseUrl } from '../packem_shared/admin-url-4UzT-CI4.mjs';
2
+ import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
3
+ import { a as resolveProductionWorkerUrl } from '../packem_shared/resolve-target-qbsJ_5sF.mjs';
4
+
5
+ const GET_FUNCTION_STATS_OP = "__lunora_admin__:getFunctionStats";
6
+ const DEFAULT_LIMIT = 10;
7
+ const TRAILING_SLASH = /\/$/u;
8
+ const toInsightRow = (stat, rate) => {
9
+ return {
10
+ calls: stat.calls,
11
+ conflicts: stat.conflicts ?? 0,
12
+ errors: stat.errors,
13
+ lastErrorMessage: stat.lastErrorMessage,
14
+ maxDurationMs: stat.maxDurationMs,
15
+ meanDurationMs: stat.calls === 0 ? 0 : stat.totalDurationMs / stat.calls,
16
+ path: stat.path,
17
+ rate
18
+ };
19
+ };
20
+ const buildInsightsReport = (functions, limit) => {
21
+ const writeContention = functions.filter((stat) => (stat.conflicts ?? 0) > 0).map((stat) => toInsightRow(stat, stat.calls === 0 ? 0 : (stat.conflicts ?? 0) / stat.calls)).toSorted((a, b) => b.rate - a.rate || b.conflicts - a.conflicts).slice(0, limit);
22
+ const errorHotspots = functions.filter((stat) => stat.errors > 0).map((stat) => toInsightRow(stat, stat.calls === 0 ? 0 : stat.errors / stat.calls)).toSorted((a, b) => b.rate - a.rate || b.errors - a.errors).slice(0, limit);
23
+ const latencyOutliers = functions.map((stat) => toInsightRow(stat, 0)).toSorted((a, b) => b.maxDurationMs - a.maxDurationMs).slice(0, limit);
24
+ return { errorHotspots, latencyOutliers, totalFunctions: functions.length, writeContention };
25
+ };
26
+ const percent = (rate) => `${(rate * 100).toFixed(1)}%`;
27
+ const formatMs = (ms) => ms < 1e3 ? `${Math.round(ms).toString()}ms` : `${(ms / 1e3).toFixed(2)}s`;
28
+ const formatSection = (heading, rows, emptyNote, renderRow) => [
29
+ heading,
30
+ ...rows.length === 0 ? [` ${emptyNote}`] : rows.map((row) => ` ${renderRow(row)}`)
31
+ ];
32
+ const formatInsightsReport = (report) => {
33
+ const errorTail = (row) => row.lastErrorMessage ? ` — ${row.lastErrorMessage}` : "";
34
+ return [
35
+ `Insights over ${report.totalFunctions.toString()} function${report.totalFunctions === 1 ? "" : "s"}`,
36
+ "",
37
+ ...formatSection(
38
+ "Write-conflict hot-spots (OCC contention — candidates for sharding):",
39
+ report.writeContention,
40
+ "none — no write conflicts observed",
41
+ (row) => `${row.path} ${row.conflicts.toString()}/${row.calls.toString()} calls (${percent(row.rate)})`
42
+ ),
43
+ "",
44
+ ...formatSection(
45
+ "Error hot-spots:",
46
+ report.errorHotspots,
47
+ "none — no errors observed",
48
+ (row) => `${row.path} ${row.errors.toString()}/${row.calls.toString()} calls (${percent(row.rate)})${errorTail(row)}`
49
+ ),
50
+ "",
51
+ ...formatSection(
52
+ "Latency outliers (slowest single call):",
53
+ report.latencyOutliers,
54
+ "none — no functions have run",
55
+ (row) => `${row.path} max ${formatMs(row.maxDurationMs)}, mean ${formatMs(row.meanDurationMs)} over ${row.calls.toString()} calls`
56
+ )
57
+ ].join("\n");
58
+ };
59
+ const resolveLimit = (raw) => {
60
+ if (raw === void 0 || !Number.isFinite(raw) || raw <= 0) {
61
+ return DEFAULT_LIMIT;
62
+ }
63
+ return Math.floor(raw);
64
+ };
65
+ const runInsightsCommand = async (options) => {
66
+ if (options.prod && options.url === void 0) {
67
+ options.logger.error("--prod requires an explicit --url (refusing to report from the implicit localhost worker)");
68
+ return { code: 1 };
69
+ }
70
+ const token = options.token ?? process.env.LUNORA_ADMIN_TOKEN;
71
+ if (!token) {
72
+ options.logger.error("admin token required — pass --token or set LUNORA_ADMIN_TOKEN");
73
+ return { code: 1 };
74
+ }
75
+ const baseUrl = resolveAdminBaseUrl(options.url, options.logger);
76
+ if (baseUrl === void 0) {
77
+ return { code: 1 };
78
+ }
79
+ const requestUrl = `${baseUrl.replace(TRAILING_SLASH, "")}/_lunora/rpc`;
80
+ const fetchImpl = globalThis.fetch;
81
+ if (typeof fetchImpl !== "function") {
82
+ throw new TypeError("no fetch implementation available — pass fetchImpl or run on Node >= 18");
83
+ }
84
+ const payload = { args: {}, functionPath: GET_FUNCTION_STATS_OP };
85
+ if (options.shard !== void 0) {
86
+ payload.shardKey = options.shard;
87
+ }
88
+ options.logger.info(`POST ${requestUrl} -> insights`);
89
+ const response = await fetchImpl(requestUrl, {
90
+ body: JSON.stringify(payload),
91
+ headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
92
+ method: "POST"
93
+ });
94
+ const text = await response.text();
95
+ if (!response.ok) {
96
+ options.logger.error(`insights failed: HTTP ${String(response.status)}: ${text}`);
97
+ return { code: 1 };
98
+ }
99
+ let parsed;
100
+ try {
101
+ parsed = JSON.parse(text);
102
+ } catch {
103
+ options.logger.error(`insights failed: worker returned non-JSON: ${text}`);
104
+ return { code: 1 };
105
+ }
106
+ const result = parsed.result ?? parsed;
107
+ const { functions } = result;
108
+ if (!Array.isArray(functions)) {
109
+ options.logger.error("insights failed: response carried no `functions` array");
110
+ return { code: 1 };
111
+ }
112
+ const report = buildInsightsReport(functions, resolveLimit(options.limit));
113
+ options.logger.info(options.json ? JSON.stringify(report, void 0, 2) : formatInsightsReport(report));
114
+ return { code: 0, report };
115
+ };
116
+ const execute = defineHandler(({ cwd, logger, options }) => {
117
+ const limit = options.limit === void 0 ? void 0 : Number.parseInt(options.limit, 10);
118
+ return runInsightsCommand({
119
+ json: options.json,
120
+ limit,
121
+ logger,
122
+ prod: options.prod,
123
+ shard: options.shard,
124
+ token: options.token,
125
+ // Fall back to the `.lunora/project.json` link when `--prod` is set, so a
126
+ // linked checkout doesn't need --url repeated for prod insights.
127
+ url: resolveProductionWorkerUrl({ cwd, prod: options.prod === true, url: options.url })
128
+ });
129
+ });
130
+
131
+ export { buildInsightsReport, execute, formatInsightsReport, runInsightsCommand };
@@ -0,0 +1,65 @@
1
+ import { existsSync, rmSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { writeLinkedProject, LINKED_PROJECT_FILE } from '@lunora/config';
4
+ import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
5
+ import { r as readWranglerName } from '../packem_shared/wrangler-name-cy4yhm9j.mjs';
6
+
7
+ const isValidWorkerUrl = (value) => {
8
+ try {
9
+ const { protocol } = new URL(value);
10
+ return protocol === "http:" || protocol === "https:";
11
+ } catch {
12
+ return false;
13
+ }
14
+ };
15
+ const runLinkRemove = (cwd, logger) => {
16
+ const path = join(cwd, LINKED_PROJECT_FILE);
17
+ if (!existsSync(path)) {
18
+ logger.warn(`link: no ${LINKED_PROJECT_FILE} to remove`);
19
+ return { code: 0 };
20
+ }
21
+ rmSync(path);
22
+ logger.success(`link: removed ${LINKED_PROJECT_FILE}`);
23
+ return { code: 0 };
24
+ };
25
+ const runLinkCommand = (options) => {
26
+ const cwd = options.cwd ?? process.cwd();
27
+ const { logger } = options;
28
+ if (options.remove) {
29
+ return runLinkRemove(cwd, logger);
30
+ }
31
+ if (options.url === void 0 || options.url === "") {
32
+ logger.error("link requires a deployed Worker URL. Usage: lunora link --url <https://your-worker>");
33
+ return { code: 1 };
34
+ }
35
+ if (!isValidWorkerUrl(options.url)) {
36
+ logger.error(`link: invalid --url "${options.url}" — expected an http(s) URL`);
37
+ return { code: 1 };
38
+ }
39
+ const now = options.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
40
+ const link = {
41
+ env: options.env,
42
+ linkedAt: now(),
43
+ workerName: options.name ?? readWranglerName(cwd),
44
+ workerUrl: options.url
45
+ };
46
+ const path = writeLinkedProject(cwd, link);
47
+ logger.success(`link: ${link.workerName ?? "(unnamed worker)"} -> ${options.url}`);
48
+ logger.info(`link: wrote ${path}`);
49
+ if (link.env !== void 0) {
50
+ logger.info(`link: environment "${link.env}"`);
51
+ }
52
+ return { code: 0, link };
53
+ };
54
+ const execute = defineHandler(
55
+ ({ cwd, logger, options }) => runLinkCommand({
56
+ cwd,
57
+ env: options.env,
58
+ logger,
59
+ name: options.name,
60
+ remove: options.remove === true,
61
+ url: options.url
62
+ })
63
+ );
64
+
65
+ export { execute, runLinkCommand };
@@ -0,0 +1,58 @@
1
+ import { readLinkedProject } from '@lunora/config';
2
+ import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
3
+ import { defaultSpawner } from '../packem_shared/defaultSpawner-DxI3mebw.mjs';
4
+
5
+ const LOG_FORMATS = /* @__PURE__ */ new Set(["json", "pretty"]);
6
+ const runLogsCommand = async (options) => {
7
+ const cwd = options.cwd ?? process.cwd();
8
+ if (options.format !== void 0 && !LOG_FORMATS.has(options.format)) {
9
+ options.logger.error(`logs: unknown --format "${options.format}" — expected pretty | json`);
10
+ return { code: 1, descriptor: void 0, error: "invalid format" };
11
+ }
12
+ const args = ["exec", "wrangler", "tail"];
13
+ if (options.worker !== void 0) {
14
+ args.push(options.worker);
15
+ }
16
+ const env = options.env ?? readLinkedProject(cwd)?.env;
17
+ if (env !== void 0) {
18
+ args.push("--env", env);
19
+ }
20
+ if (options.format !== void 0) {
21
+ args.push("--format", options.format);
22
+ }
23
+ if (options.status !== void 0) {
24
+ args.push("--status", options.status);
25
+ }
26
+ if (options.search !== void 0) {
27
+ args.push("--search", options.search);
28
+ }
29
+ if (options.temporary) {
30
+ args.push("--temporary");
31
+ }
32
+ const descriptor = {
33
+ args,
34
+ command: "pnpm",
35
+ cwd
36
+ };
37
+ options.logger.info(`tailing logs via ${descriptor.command} ${descriptor.args.join(" ")}`);
38
+ const spawner = options.spawner ?? defaultSpawner;
39
+ const result = await spawner(descriptor);
40
+ return {
41
+ code: result.code,
42
+ descriptor
43
+ };
44
+ };
45
+ const execute = defineHandler(
46
+ ({ argument, cwd, logger, options }) => runLogsCommand({
47
+ cwd,
48
+ env: options.env,
49
+ format: options.format,
50
+ logger,
51
+ search: options.search,
52
+ status: options.status,
53
+ temporary: options.temporary === true,
54
+ worker: argument[0]
55
+ })
56
+ );
57
+
58
+ export { execute, runLogsCommand };
@@ -0,0 +1,79 @@
1
+ import { runCodegen } from '@lunora/codegen';
2
+ import { validateWranglerProject, inferLunoraBindings, reconcileWranglerBindings } from '@lunora/config';
3
+ import { p as parseApiSpec } from '../packem_shared/api-spec-CtA6ilu4.mjs';
4
+ import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
5
+ import { r as runSchemaDriftGate } from '../packem_shared/schema-drift-gate-BtBt0as0.mjs';
6
+
7
+ const provisionBindings = async (cwd, logger) => {
8
+ try {
9
+ const inferred = await inferLunoraBindings({ projectRoot: cwd });
10
+ const reconciled = reconcileWranglerBindings(cwd, inferred);
11
+ if (reconciled.changed) {
12
+ logger.success(`provisioned bindings: ${reconciled.added.join(", ")} → ${reconciled.wranglerPath ?? "wrangler.jsonc"}`);
13
+ }
14
+ for (const warning of reconciled.warnings) {
15
+ logger.warn(warning);
16
+ }
17
+ } catch (error) {
18
+ const message = error instanceof Error ? error.message : String(error);
19
+ logger.warn(`binding inference skipped: ${message}`);
20
+ }
21
+ };
22
+ const runPrepareCommand = async (options) => {
23
+ const cwd = options.cwd ?? process.cwd();
24
+ options.logger.info("running codegen");
25
+ let codegen;
26
+ try {
27
+ codegen = runCodegen({ apiSpec: options.apiSpec, projectRoot: cwd });
28
+ options.logger.success("codegen complete");
29
+ } catch (error) {
30
+ const message = error instanceof Error ? error.message : String(error);
31
+ options.logger.error(`codegen failed: ${message}`);
32
+ return {
33
+ code: 1,
34
+ error: `codegen failed: ${message}`,
35
+ validation: { problems: [], wranglerPath: void 0 }
36
+ };
37
+ }
38
+ const gate = runSchemaDriftGate({
39
+ allowDrift: options.allowSchemaDrift === true,
40
+ codegen,
41
+ logger: options.logger,
42
+ updateBaseline: options.updateSchemaBaseline === true
43
+ });
44
+ if (gate.blocked) {
45
+ return {
46
+ code: 1,
47
+ error: "schema drift gate blocked prepare",
48
+ schemaDrift: { blocked: true, reason: gate.reason },
49
+ validation: { problems: [], wranglerPath: void 0 }
50
+ };
51
+ }
52
+ await provisionBindings(cwd, options.logger);
53
+ const validation = validateWranglerProject({ projectRoot: cwd });
54
+ if (validation.problems.length > 0) {
55
+ options.logger.error("wrangler.jsonc validation failed:");
56
+ for (const problem of validation.problems) {
57
+ options.logger.error(` - ${problem}`);
58
+ }
59
+ return {
60
+ code: 1,
61
+ error: "wrangler validation failed",
62
+ validation
63
+ };
64
+ }
65
+ gate.rebless?.();
66
+ options.logger.success("project is ready to deploy");
67
+ return { code: 0, validation };
68
+ };
69
+ const execute = defineHandler(
70
+ ({ cwd, logger, options }) => runPrepareCommand({
71
+ allowSchemaDrift: options.allowSchemaDrift === true,
72
+ apiSpec: parseApiSpec(options.apiSpec),
73
+ cwd,
74
+ logger,
75
+ updateSchemaBaseline: options.updateSchemaBaseline === true
76
+ })
77
+ );
78
+
79
+ export { execute, runPrepareCommand };