@alicesystems/cli 0.1.0-alpha.2 → 0.1.0-alpha.3

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 (70) hide show
  1. package/README.md +6 -0
  2. package/dist/add-db.d.ts +1 -0
  3. package/dist/add-db.js +12 -2
  4. package/dist/add-input.d.ts +117 -0
  5. package/dist/add-input.js +137 -0
  6. package/dist/add-json.d.ts +3 -0
  7. package/dist/add-json.js +61 -0
  8. package/dist/add-shared-package.js +16 -2
  9. package/dist/alice-record-update.d.ts +20 -0
  10. package/dist/alice-record-update.js +127 -0
  11. package/dist/application-integration.js +22 -4
  12. package/dist/index.js +48 -4
  13. package/dist/init-input.d.ts +30 -0
  14. package/dist/init-input.js +48 -0
  15. package/dist/init.d.ts +2 -0
  16. package/dist/init.js +45 -1
  17. package/dist/templates/database/mysql/docker-compose.yml +20 -0
  18. package/dist/templates/database/postgres/docker-compose.yml +20 -0
  19. package/dist/templates/project/alice.json.tpl +1 -0
  20. package/dist/templates/project/apps/mobile/README.md.tpl +8 -0
  21. package/dist/templates/project/apps/mobile/css.d.ts +1 -0
  22. package/dist/templates/project/apps/mobile/global.css +6 -0
  23. package/dist/templates/project/apps/mobile/metro.config.js +4 -0
  24. package/dist/templates/project/apps/mobile/nativewind-env.d.ts +3 -0
  25. package/dist/templates/project/apps/mobile/package.json.tpl +9 -0
  26. package/dist/templates/project/apps/mobile/postcss.config.mjs +5 -0
  27. package/dist/templates/project/apps/mobile/{app → src/app}/_layout.tsx +1 -0
  28. package/dist/templates/project/apps/mobile/src/app/index.tsx.tpl +61 -0
  29. package/dist/templates/project/apps/mobile/tsconfig.json.tpl +1 -1
  30. package/dist/templates/project/oxlint.config.mts.tpl +2 -0
  31. package/dist/templates/project/packages/user-interface/README.md.tpl +3 -2
  32. package/dist/templates/project/packages/user-interface/package.json.tpl +1 -0
  33. package/dist/templates/project/packages/user-interface/src/styles/native.css +72 -0
  34. package/dist/templates/project/packages/user-interface/tests/user-interface.test.tsx +14 -0
  35. package/dist/templates/project/pnpm-workspace.yaml.tpl +4 -0
  36. package/node_modules/@alice/core/dist/alice-record.d.ts +139 -0
  37. package/node_modules/@alice/core/dist/alice-record.js +215 -0
  38. package/node_modules/@alice/core/dist/database-recipe.d.ts +12 -0
  39. package/node_modules/@alice/core/dist/database-recipe.js +8 -0
  40. package/node_modules/@alice/core/dist/index.d.ts +2 -0
  41. package/node_modules/@alice/core/dist/index.js +1 -0
  42. package/node_modules/@alice/core/dist/project-init.js +53 -18
  43. package/package.json +1 -1
  44. package/dist/templates/project/apps/mobile/app/index.tsx.tpl +0 -90
  45. package/dist/templates/project/packages/cache/README.md.tpl +0 -42
  46. package/dist/templates/project/packages/cache/package.json.tpl +0 -26
  47. package/dist/templates/project/packages/cache/src/cache.ts +0 -50
  48. package/dist/templates/project/packages/cache/src/create-cache.ts +0 -16
  49. package/dist/templates/project/packages/cache/src/index.ts +0 -4
  50. package/dist/templates/project/packages/cache/src/memory-cache.ts +0 -147
  51. package/dist/templates/project/packages/cache/tests/cache.test.mjs +0 -83
  52. package/dist/templates/project/packages/cache/tsconfig.json.tpl +0 -1
  53. package/dist/templates/project/packages/errors/src/app-error.ts +0 -31
  54. package/dist/templates/project/packages/errors/src/codes.ts +0 -29
  55. package/dist/templates/project/packages/errors/src/response.ts +0 -46
  56. package/dist/templates/project/packages/observability/README.md.tpl +0 -30
  57. package/dist/templates/project/packages/observability/package.json.tpl +0 -26
  58. package/dist/templates/project/packages/observability/src/error-reporting.ts +0 -23
  59. package/dist/templates/project/packages/observability/src/index.ts +0 -13
  60. package/dist/templates/project/packages/observability/src/logger.ts +0 -123
  61. package/dist/templates/project/packages/observability/src/tracing.ts +0 -41
  62. package/dist/templates/project/packages/observability/tests/observability.test.mjs +0 -92
  63. package/dist/templates/project/packages/observability/tsconfig.json.tpl +0 -1
  64. package/dist/templates/project/packages/user-interface/src/index.ts +0 -2
  65. package/dist/templates/project/packages/user-interface/src/web/button.tsx +0 -33
  66. package/dist/templates/project/packages/user-interface/src/web/card.tsx +0 -13
  67. package/dist/templates/project/packages/user-interface/src/web/cn.ts +0 -6
  68. package/dist/templates/project/packages/user-interface/src/web/index.ts +0 -4
  69. package/dist/templates/project/packages/user-interface/tests/user-interface.test.mjs +0 -49
  70. package/dist/templates/project/packages/user-interface/theme.css +0 -37
@@ -1,123 +0,0 @@
1
- export const logLevels = ["debug", "info", "warn", "error"] as const;
2
- export type LogLevel = (typeof logLevels)[number];
3
- export type LogFields = Readonly<Record<string, unknown>>;
4
-
5
- export interface LogRecord {
6
- readonly level: LogLevel;
7
- readonly message: string;
8
- readonly time: string;
9
- readonly fields: LogFields;
10
- }
11
- export type LogSink = (record: LogRecord) => void;
12
-
13
- export interface Logger {
14
- readonly debug: (message: string, fields?: LogFields) => void;
15
- readonly info: (message: string, fields?: LogFields) => void;
16
- readonly warn: (message: string, fields?: LogFields) => void;
17
- readonly error: (message: string, fields?: LogFields) => void;
18
- /** A logger that adds `fields` to every record. */
19
- readonly child: (fields: LogFields) => Logger;
20
- }
21
-
22
- export interface LoggerOptions {
23
- /** Minimum level to emit. Defaults to `info`. */
24
- readonly level?: LogLevel;
25
- /** Where records go. Defaults to {@link consoleJsonSink}. */
26
- readonly sink?: LogSink;
27
- readonly fields?: LogFields;
28
- /** Clock override for tests. */
29
- readonly now?: () => Date;
30
- /** Extra field-name fragments to redact, added to the defaults. */
31
- readonly redact?: readonly string[];
32
- }
33
-
34
- const defaultRedactions = [
35
- "password",
36
- "secret",
37
- "token",
38
- "authorization",
39
- "cookie",
40
- "apikey",
41
- "api_key",
42
- "credential",
43
- "connectionstring",
44
- ];
45
- const redacted = "[redacted]";
46
-
47
- function sanitise(
48
- value: unknown,
49
- fragments: readonly string[],
50
- depth: number
51
- ): unknown {
52
- if (value instanceof Error) {
53
- return { message: value.message, name: value.name };
54
- }
55
- if (depth > 4 || value === null || typeof value !== "object") {
56
- return value;
57
- }
58
- if (Array.isArray(value)) {
59
- return value.map((item) => sanitise(item, fragments, depth + 1));
60
- }
61
- return Object.fromEntries(
62
- Object.entries(value).map(([key, item]) => {
63
- const lowered = key.toLowerCase();
64
- return [
65
- key,
66
- fragments.some((fragment) => lowered.includes(fragment))
67
- ? redacted
68
- : sanitise(item, fragments, depth + 1),
69
- ];
70
- })
71
- );
72
- }
73
-
74
- /** Writes one JSON line per record to stdout (stderr for `error`). */
75
- export const consoleJsonSink: LogSink = (record) => {
76
- const line = JSON.stringify({
77
- ...record.fields,
78
- level: record.level,
79
- message: record.message,
80
- time: record.time,
81
- });
82
- if (record.level === "error") {
83
- console.error(line);
84
- } else {
85
- console.log(line);
86
- }
87
- };
88
-
89
- /** Structured logger. Field names containing password, token, secret, cookie, etc. are redacted. */
90
- export function createLogger(options: LoggerOptions = {}): Logger {
91
- const threshold = logLevels.indexOf(options.level ?? "info");
92
- const sink = options.sink ?? consoleJsonSink;
93
- const now = options.now ?? (() => new Date());
94
- const fragments = [
95
- ...defaultRedactions,
96
- ...(options.redact ?? []).map((fragment) => fragment.toLowerCase()),
97
- ];
98
- const build = (base: LogFields): Logger => {
99
- const write = (
100
- level: LogLevel,
101
- message: string,
102
- fields: LogFields = {}
103
- ) => {
104
- if (logLevels.indexOf(level) < threshold) {
105
- return;
106
- }
107
- sink({
108
- fields: sanitise({ ...base, ...fields }, fragments, 0) as LogFields,
109
- level,
110
- message,
111
- time: now().toISOString(),
112
- });
113
- };
114
- return {
115
- child: (fields) => build({ ...base, ...fields }),
116
- debug: (message, fields) => write("debug", message, fields),
117
- error: (message, fields) => write("error", message, fields),
118
- info: (message, fields) => write("info", message, fields),
119
- warn: (message, fields) => write("warn", message, fields),
120
- };
121
- };
122
- return build(options.fields ?? {});
123
- }
@@ -1,41 +0,0 @@
1
- export type SpanAttributes = Readonly<
2
- Record<string, string | number | boolean>
3
- >;
4
-
5
- export interface Span {
6
- readonly recordError: (error: unknown) => void;
7
- readonly end: () => void;
8
- }
9
- export interface Tracer {
10
- readonly startSpan: (name: string, attributes?: SpanAttributes) => Span;
11
- }
12
-
13
- /**
14
- * **Tracing is not implemented.** This tracer records nothing; it exists so code can be written
15
- * against the {@link Tracer} contract today. Supply a real tracer (for example one backed by
16
- * OpenTelemetry) from your application to get spans.
17
- */
18
- const doNothing = (): void => {
19
- // Intentionally inactive: no tracing backend is configured.
20
- };
21
- export const inactiveTracer: Tracer = {
22
- startSpan: () => ({ end: doNothing, recordError: doNothing }),
23
- };
24
-
25
- /** Run `operation` inside a span, recording errors and always ending the span. */
26
- export async function withSpan<Result>(
27
- tracer: Tracer,
28
- name: string,
29
- operation: (span: Span) => Promise<Result> | Result,
30
- attributes?: SpanAttributes
31
- ): Promise<Result> {
32
- const span = tracer.startSpan(name, attributes);
33
- try {
34
- return await operation(span);
35
- } catch (error) {
36
- span.recordError(error);
37
- throw error;
38
- } finally {
39
- span.end();
40
- }
41
- }
@@ -1,92 +0,0 @@
1
- import assert from "node:assert/strict";
2
- import test from "node:test";
3
-
4
- import {
5
- createLogger,
6
- createLoggerErrorReporter,
7
- inactiveTracer,
8
- withSpan,
9
- } from "../dist/index.js";
10
-
11
- const fixed = () => new Date("2026-01-02T03:04:05.000Z");
12
- function capture(options = {}) {
13
- const records = [];
14
- const logger = createLogger({
15
- now: fixed,
16
- sink: (r) => records.push(r),
17
- ...options,
18
- });
19
- return { logger, records };
20
- }
21
-
22
- test("records carry level, message, time and fields", () => {
23
- const { logger, records } = capture({ fields: { service: "api" } });
24
- logger.info("started", { port: 3001 });
25
- assert.deepEqual(records, [
26
- {
27
- fields: { port: 3001, service: "api" },
28
- level: "info",
29
- message: "started",
30
- time: "2026-01-02T03:04:05.000Z",
31
- },
32
- ]);
33
- });
34
- test("records below the level are dropped", () => {
35
- const { logger, records } = capture({ level: "warn" });
36
- logger.debug("a");
37
- logger.info("b");
38
- logger.warn("c");
39
- logger.error("d");
40
- assert.deepEqual(
41
- records.map((r) => r.message),
42
- ["c", "d"]
43
- );
44
- });
45
- test("child loggers add fields", () => {
46
- const { logger, records } = capture();
47
- logger.child({ requestId: "r1" }).info("x", { a: 1 });
48
- assert.deepEqual(records[0].fields, { a: 1, requestId: "r1" });
49
- });
50
- test("sensitive fields are redacted, including nested and custom ones", () => {
51
- const { logger, records } = capture({ redact: ["ssn"] });
52
- logger.info("x", {
53
- nested: { accessToken: "t", ok: 1 },
54
- password: "hunter2",
55
- ssn: "123",
56
- user: new Error("boom"),
57
- });
58
- const text = JSON.stringify(records[0].fields);
59
- assert.doesNotMatch(text, /hunter2|"t"|123/u);
60
- assert.equal(records[0].fields.nested.ok, 1);
61
- assert.equal(records[0].fields.password, "[redacted]");
62
- });
63
- test("the error reporter logs through the logger without the stack", () => {
64
- const { logger, records } = capture();
65
- createLoggerErrorReporter(logger).report(new TypeError("bad"), {
66
- route: "/x",
67
- });
68
- assert.equal(records[0].level, "error");
69
- assert.equal(records[0].message, "bad");
70
- assert.deepEqual(records[0].fields, { errorName: "TypeError", route: "/x" });
71
- });
72
- test("withSpan records errors and always ends the span", async () => {
73
- const events = [];
74
- const tracer = {
75
- startSpan(name) {
76
- events.push(`start:${name}`);
77
- return {
78
- end: () => events.push("end"),
79
- recordError: (e) => events.push(`error:${e.message}`),
80
- };
81
- },
82
- };
83
- assert.equal(await withSpan(tracer, "ok", () => 5), 5);
84
- await assert.rejects(
85
- withSpan(tracer, "bad", () => {
86
- throw new Error("x");
87
- }),
88
- /x/u
89
- );
90
- assert.deepEqual(events, ["start:ok", "end", "start:bad", "error:x", "end"]);
91
- assert.equal(await withSpan(inactiveTracer, "n", () => 1), 1);
92
- });
@@ -1 +0,0 @@
1
- { "extends": "@alice/typescript/library.json" }
@@ -1,2 +0,0 @@
1
- export { colors, radius, spacing } from "./tokens.js";
2
- export type { ColorScheme, ColorToken } from "./tokens.js";
@@ -1,33 +0,0 @@
1
- /* oxlint-disable react/button-has-type -- `type` is constrained to button | submit | reset by ComponentProps and defaults to "button" */
2
- import type { ComponentProps } from "react";
3
-
4
- import { cn } from "./cn.js";
5
-
6
- export type ButtonVariant = "primary" | "secondary";
7
-
8
- const variants: Readonly<Record<ButtonVariant, string>> = {
9
- primary: "bg-accent text-background hover:opacity-90",
10
- secondary: "border border-border bg-muted text-foreground hover:opacity-90",
11
- };
12
-
13
- export interface ButtonProps extends ComponentProps<"button"> {
14
- readonly variant?: ButtonVariant;
15
- }
16
-
17
- export const Button = ({
18
- className,
19
- type = "button",
20
- variant = "primary",
21
- ...props
22
- }: ButtonProps) => (
23
- // oxlint-disable-next-line react/button-has-type -- `type` is constrained to button | submit | reset by ComponentProps and defaults to "button"
24
- <button
25
- className={cn(
26
- "focus-visible:outline-accent inline-flex h-10 items-center justify-center rounded-md px-4 text-sm font-medium focus-visible:outline-2 focus-visible:outline-offset-2 disabled:opacity-50",
27
- variants[variant],
28
- className
29
- )}
30
- type={type}
31
- {...props}
32
- />
33
- );
@@ -1,13 +0,0 @@
1
- import type { ComponentProps } from "react";
2
-
3
- import { cn } from "./cn.js";
4
-
5
- export const Card = ({ className, ...props }: ComponentProps<"section">) => (
6
- <section
7
- className={cn(
8
- "border-border bg-muted text-foreground rounded-lg border p-4",
9
- className
10
- )}
11
- {...props}
12
- />
13
- );
@@ -1,6 +0,0 @@
1
- /** Join class names, skipping falsy values. */
2
- export function cn(
3
- ...classes: readonly (string | false | null | undefined)[]
4
- ): string {
5
- return classes.filter(Boolean).join(" ");
6
- }
@@ -1,4 +0,0 @@
1
- export { Button } from "./button.js";
2
- export type { ButtonProps, ButtonVariant } from "./button.js";
3
- export { Card } from "./card.js";
4
- export { cn } from "./cn.js";
@@ -1,49 +0,0 @@
1
- import assert from "node:assert/strict";
2
- import fs from "node:fs/promises";
3
- import test from "node:test";
4
-
5
- import { createElement } from "react";
6
- import { renderToStaticMarkup } from "react-dom/server";
7
-
8
- import { colors, spacing } from "../dist/index.js";
9
- import { Button, Card, cn } from "../dist/web/index.js";
10
-
11
- test("tokens stay in sync with theme.css", async () => {
12
- const css = await fs.readFile(
13
- new URL("../theme.css", import.meta.url),
14
- "utf-8"
15
- );
16
- for (const scheme of Object.values(colors)) {
17
- for (const value of Object.values(scheme)) {
18
- assert.ok(css.includes(value), `theme.css is missing ${value}`);
19
- }
20
- }
21
- assert.equal(typeof spacing.md, "number");
22
- });
23
- test("cn joins truthy classes", () => {
24
- assert.equal(cn("a", false, undefined, null, "b"), "a b");
25
- });
26
- test("components render accessible, safe markup", () => {
27
- const button = renderToStaticMarkup(
28
- createElement(Button, { variant: "secondary" }, "Go")
29
- );
30
- assert.match(
31
- button,
32
- /^<button class="[^"]*border-border[^"]*" type="button">Go<\/button>$/u
33
- );
34
- const submit = renderToStaticMarkup(
35
- createElement(Button, { type: "submit" }, "Send")
36
- );
37
- assert.match(submit, /type="submit"/u);
38
- assert.match(
39
- renderToStaticMarkup(createElement(Card, { "aria-label": "Status" }, "x")),
40
- /^<section class="[^"]*" aria-label="Status">x<\/section>$/u
41
- );
42
- });
43
- test("the package does not depend on a DOM renderer at runtime", async () => {
44
- const manifest = JSON.parse(
45
- await fs.readFile(new URL("../package.json", import.meta.url), "utf-8")
46
- );
47
- assert.equal(manifest.dependencies?.["react-dom"], undefined);
48
- assert.equal(manifest.peerDependencies["react-dom"], undefined);
49
- });
@@ -1,37 +0,0 @@
1
- /*
2
- * Tailwind v4 theme tokens. Import from your global stylesheet:
3
- * @import "tailwindcss";
4
- * @import "@alice/user-interface/theme.css";
5
- * @source "<path to this package>/src";
6
- * Values mirror src/tokens.ts.
7
- */
8
- :root {
9
- --background: #fcfcfc;
10
- --foreground: #1f2329;
11
- --muted: #f1f2f4;
12
- --muted-foreground: #5b616b;
13
- --border: #e3e5e8;
14
- --accent: #16a34a;
15
- }
16
-
17
- @media (prefers-color-scheme: dark) {
18
- :root {
19
- --background: #16181d;
20
- --foreground: #f5f5f5;
21
- --muted: #22252b;
22
- --muted-foreground: #b6bac2;
23
- --border: #343841;
24
- --accent: #4ade80;
25
- }
26
- }
27
-
28
- @theme inline {
29
- --color-background: var(--background);
30
- --color-foreground: var(--foreground);
31
- --color-muted: var(--muted);
32
- --color-muted-foreground: var(--muted-foreground);
33
- --color-border: var(--border);
34
- --color-accent: var(--accent);
35
- --font-sans: ui-sans-serif, system-ui, sans-serif;
36
- --font-mono: ui-monospace, "SFMono-Regular", Menlo, Consolas, monospace;
37
- }