npm - @slopware/sloppy-darwin-arm64 - Versions diffs - 0.1.0-alpha.0 - Mend

@@ -0,0 +1,44 @@
+# Package API Starter
+This public alpha, pre-production backend starter uses a compatible local
+pure-JS package through an npm `file:` dependency. It does not require internet
+access.
+Package support is experimental. Sloppy consumes packages that are already
+installed in `node_modules`, bundles compatible pure-JS modules into the
+generated artifacts, and records the graph for `sloppy deps`. This is not full
+npm ecosystem compatibility; native addons and N-API are unsupported.
+Packages must use JavaScript and runtime APIs Sloppy can transform and shim.
+The package resolver supports common `exports`, `imports`, condition,
+subpath, JSON, and CommonJS patterns, but unsupported export shapes fail
+clearly instead of falling back silently.
+The supported Node compatibility surface is documented in
+`docs/reference/node-compatibility.md`.
+```sh
+npm install --ignore-scripts --no-audit
+sloppy build
+sloppy deps .sloppy
+sloppy deps .sloppy --explain
+sloppy deps .sloppy --format json
+sloppy run .sloppy --once GET /health
+sloppy run .sloppy --once GET /users/Ada
+sloppy package
+sloppy run .sloppy/package --once GET /health
+sloppy run .sloppy/package --once GET /users/Ada
+```
+The packaged app contains the bundled dependency graph and does not need
+`node_modules` at runtime.
+The supported package shapes are committed in
+[`tests/fixtures/npm-compat/`](../../tests/fixtures/npm-compat) and the
+runtime behaviors Sloppy currently exercises are committed in
+[`tests/fixtures/npm-runtime/`](../../tests/fixtures/npm-runtime). The
+resolver matrix proves package shapes resolve; the runtime matrix proves
+selected package behaviors execute after packaging. Adding a real package
+outside either matrix may surface a clear unsupported-shape diagnostic; the
+diagnostic identifies the package, the field, the subpath, and the reason.
+The optional `tools/scripts/npm-compat-smoke.mjs` script can install a
+curated list of small pure-JS packages and try to build them; it is advisory,
+not a release gate.

@@ -0,0 +1,7 @@
+export function isUserName(value) {
+    return typeof value === "string" && value.trim() === value && value.length >= 2;
+}
+export function normalizeName(value) {
+    return typeof value === "string" ? value.trim() : "";
+}

@@ -0,0 +1,6 @@
+{
+  "name": "validator-lite",
+  "version": "0.0.0",
+  "type": "module",
+  "exports": "./index.js"
+}

@@ -0,0 +1,3 @@
+.sloppy/
+node_modules/
+package-lock.json

@@ -0,0 +1,17 @@
+{
+  "name": "sloppy-package-api-starter",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "validator-lite": "file:./fixtures/validator-lite"
+  },
+  "devDependencies": {
+    "@slopware/sloppy": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "build": "sloppy build",
+    "run": "sloppy run .sloppy",
+    "package": "sloppy package",
+    "deps": "sloppy deps .sloppy"
+  }
+}

@@ -0,0 +1,5 @@
+{
+  "entry": "src/main.ts",
+  "outDir": ".sloppy",
+  "environment": "Development"
+}

@@ -0,0 +1,10 @@
+import { Sloppy } from "sloppy";
+import { healthModule } from "./routes/health.ts";
+import { usersModule } from "./routes/users.ts";
+const app = Sloppy.create();
+app.useModule(healthModule);
+app.useModule(usersModule);
+export default app;

@@ -0,0 +1,5 @@
+import { Results } from "sloppy";
+export function healthModule(app) {
+    app.get("/health", () => Results.text("ok")).withName("Health.Get");
+}

@@ -0,0 +1,12 @@
+import { Results } from "sloppy";
+import { isUserName, normalizeName } from "validator-lite";
+export function usersModule(app) {
+    app.get("/users/{name}", (ctx) => {
+        const name = normalizeName(ctx.route.name);
+        return Results.ok({
+            name,
+            valid: isUserName(name),
+        });
+    }).withName("Users.Validate");
+}

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "allowImportingTsExtensions": true,
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "noEmit": true,
+    "target": "ES2022",
+    "types": [
+      "@slopware/sloppy"
+    ]
+  },
+  "include": [
+    "src/**/*.ts"
+  ]
+}

@@ -0,0 +1,12 @@
+# Program Mode Template
+This is the smallest public alpha, pre-production route-free Program Mode
+starter for console tools, local jobs, and scripts.
+```sh
+sloppy run src/main.ts -- --name Ada
+sloppy build
+sloppy run .sloppy -- --name Ada
+sloppy package
+sloppy run .sloppy/package -- --name Ada
+```

@@ -0,0 +1,9 @@
+export async function main(args, ctx) {
+    const nameFlag = args.indexOf("--name");
+    const name = nameFlag >= 0 && args[nameFlag + 1] ? args[nameFlag + 1] : "Sloppy";
+    console.log(`Hello, ${name}.`);
+    console.log(`cwd=${ctx.cwd}`);
+    console.log(`environment=${ctx.environment}`);
+    return 0;
+}

	@@ -0,0 +1 @@
1	+ .sloppy/

@slopware/sloppy-darwin-arm64 0.1.0-alpha.0