chore(packages): publishing metadata for the 73 published packages — per-format types, sideEffects, publishConfig, and 18 missing READMEs

.changeset/26095-publishing-metadata.md

@@ -0,0 +1,87 @@
+---
+'@objectstack/account': patch
+'@objectstack/cli': patch
+'@objectstack/client': patch
+'@objectstack/client-react': patch
+'@objectstack/cloud-connection': patch
+'@objectstack/connector-imap': patch
+'@objectstack/connector-mcp': patch
+'@objectstack/connector-openapi': patch
+'@objectstack/connector-rest': patch
+'@objectstack/connector-slack': patch
+'@objectstack/console': patch
+'@objectstack/core': patch
+'@objectstack/driver-memory': patch
+'@objectstack/driver-mongodb': patch
+'@objectstack/driver-sql': patch
+'@objectstack/driver-sqlite-wasm': patch
+'@objectstack/driver-turso': patch
+'@objectstack/embedder-openai': patch
+'@objectstack/formula': patch
+'@objectstack/hono': patch
+'@objectstack/knowledge-memory': patch
+'@objectstack/knowledge-ragflow': patch
+'@objectstack/lint': patch
+'@objectstack/mcp': patch
+'@objectstack/metadata': patch
+'@objectstack/metadata-core': patch
+'@objectstack/metadata-fs': patch
+'@objectstack/metadata-protocol': patch
+'@objectstack/objectql': patch
+'@objectstack/observability': patch
+'@objectstack/organizations': patch
+'@objectstack/platform-objects': patch
+'@objectstack/plugin-approvals': patch
+'@objectstack/plugin-audit': patch
+'@objectstack/plugin-auth': patch
+'@objectstack/plugin-dev': patch
+'@objectstack/plugin-email': patch
+'@objectstack/plugin-hono-server': patch
+'@objectstack/plugin-pinyin-search': patch
+'@objectstack/plugin-security': patch
+'@objectstack/plugin-sharing': patch
+'@objectstack/plugin-webhooks': patch
+'@objectstack/rest': patch
+'@objectstack/runtime': patch
+'@objectstack/sdui-parser': patch
+'@objectstack/service-analytics': patch
+'@objectstack/service-automation': patch
+'@objectstack/service-cache': patch
+'@objectstack/service-cluster': patch
+'@objectstack/service-cluster-redis': patch
+'@objectstack/service-datasource': patch
+'@objectstack/service-i18n': patch
+'@objectstack/service-job': patch
+'@objectstack/service-knowledge': patch
+'@objectstack/service-mailbox': patch
+'@objectstack/service-messaging': patch
+'@objectstack/service-package': patch
+'@objectstack/service-print': patch
+'@objectstack/service-queue': patch
+'@objectstack/service-realtime': patch
+'@objectstack/service-settings': patch
+'@objectstack/service-sms': patch
+'@objectstack/service-storage': patch
+'@objectstack/setup': patch
+'@objectstack/skills': patch
+'@objectstack/spec': patch
+'@objectstack/studio': patch
+'@objectstack/trigger-api': patch
+'@objectstack/trigger-record-change': patch
+'@objectstack/trigger-schedule': patch
+'@objectstack/types': patch
+'@objectstack/verify': patch
+'create-objectstack': patch---
+
+chore(packages): publishing metadata — per-format types in `exports`, declared `sideEffects`, and a README for the 18 published packages without one
+
+Clause-②: no
+Metadata-protocol: none
+
+Measured on a fresh `origin/main` build of all 73 published packages outside `ui/`, each staged as `npm pack` would ship it, with publint 0.3.25 and @arethetypeswrong/cli 0.18.5. Before: 73 of 73 packages carried at least one publint message and 48 carried an attw problem. After: 3 packages carry a publint message and 16 carry an attw problem, each remaining class needing a change this one deliberately does not make — an export-map shape change, or a dual-build fix in `@objectstack/core`.
+
+- **Types per module format.** On 38 manifests one `types` entry served both formats, so a TypeScript consumer importing the ESM build was handed the CJS declarations — every one of attw's 38 `FalseCJS`. Each `{types, import, require}` entry becomes `{import: {types, default}, require: {types, default}}` pointing at the declaration file the same tsup run already emits for that format. No subpath is added or removed, and no JavaScript target moves. `@objectstack/core` keeps its single `types` entry: its `.d.ts` and `.d.cts` declare the same classes with private members, so serving them per format gives a consumer that reaches `core` through both resolution modes two incompatible `ObjectKernel` types, which is `@objectstack/plugin-dev`'s declaration build (it awaits `import('@objectstack/objectql')` inside a CommonJS build). Its `FalseESM` therefore stays, measured and unfixed here.
+- **`sideEffects` on the 72 manifests that declared none**, read per package rather than set in bulk: `@objectstack/service-cluster-redis` registers its `redis` cluster driver at module load and `create-objectstack`'s bin reaches its program through a bare import, so both declare their entry files side-effectful; everything else is `false`.
+- **`publishConfig: { access: 'public' }`** on the 17 that had none, the value the other 56 already declare.
+- **`type`** on the 39 that shipped `.js` without declaring a format — every `.js` under their `dist/` was read first and is CommonJS, which is what the absent field already meant — **`engines.node >= 22.0.0`** on the 22 that had no `engines`, and **`repository.url`** as the full `git+https://` git URL on 71.
+- **A README for 18 published packages that had none**: one paragraph, the first import a reader writes, and a link to the package's docs page. They are the pages npm renders, and for these 18 npm rendered nothing.

packages/adapters/hono/package.json

@@ -2,13 +2,20 @@
   "name": "@objectstack/hono",
   "version": "18.1.0",
   "license": "Apache-2.0",
+  "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
     }
   },
   "scripts": {
@@ -42,7 +49,7 @@
   "author": "ObjectStack",
   "repository": {
     "type": "git",
-    "url": "https://github.com/objectstack-ai/objectstack.git",
+    "url": "git+https://github.com/objectstack-ai/objectstack.git",
     "directory": "packages/adapters/hono"
   },
   "homepage": "https://objectstack.ai/docs",

packages/apps/account/README.md

@@ -0,0 +1,9 @@
+# @objectstack/account
+
+The end-user Account app: the self-service app that navigates the identity objects owned by `@objectstack/plugin-auth`. It is a console navigation-shell app packaged as its own ObjectStack app package (ADR-0048: one app per package), so `/apps/account` resolves to exactly this app. `AccountAppPlugin` registers its manifest with the kernel.
+
+```typescript
+import { AccountAppPlugin } from '@objectstack/account';
+```
+
+Documentation: [Apps](https://objectstack.ai/docs/ui/apps)

packages/apps/account/package.json

@@ -3,13 +3,20 @@
   "version": "18.1.0",
   "license": "Apache-2.0",
   "description": "ObjectStack Account — the end-user account/self-service console app, packaged as its own ObjectStack app package (ADR-0048: one app per package).",
+  "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
     }
   },
   "scripts": {
@@ -34,7 +41,7 @@
   "author": "ObjectStack",
   "repository": {
     "type": "git",
-    "url": "https://github.com/objectstack-ai/objectstack.git",
+    "url": "git+https://github.com/objectstack-ai/objectstack.git",
     "directory": "packages/apps/account"
   },
   "homepage": "https://objectstack.ai/docs",

packages/apps/setup/README.md

@@ -0,0 +1,9 @@
+# @objectstack/setup
+
+The Setup app: the platform administration app, plus the baseline Setup navigation that other packages extend. It is a console navigation-shell app packaged as its own ObjectStack app package (ADR-0048: one app per package), so `/apps/setup` resolves to exactly this app. `SetupAppPlugin` registers its manifest with the kernel.
+
+```typescript
+import { SetupAppPlugin } from '@objectstack/setup';
+```
+
+Documentation: [The Setup app](https://objectstack.ai/docs/ui/setup-app)

packages/apps/setup/package.json

@@ -3,13 +3,20 @@
   "version": "18.1.0",
   "license": "Apache-2.0",
   "description": "ObjectStack Setup — the platform administration app, packaged as its own ObjectStack app package (ADR-0048: one app per package).",
+  "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
     }
   },
   "scripts": {
@@ -34,7 +41,7 @@
   "author": "ObjectStack",
   "repository": {
     "type": "git",
-    "url": "https://github.com/objectstack-ai/objectstack.git",
+    "url": "git+https://github.com/objectstack-ai/objectstack.git",
     "directory": "packages/apps/setup"
   },
   "homepage": "https://objectstack.ai/docs",

packages/apps/studio/README.md

@@ -0,0 +1,9 @@
+# @objectstack/studio
+
+The Studio app: the metadata builder, packaged as its own ObjectStack app package (ADR-0048: one app per package). A stock boot does not register it, because the console ships a dedicated Studio surface; a host that wants Studio as a navigable app registers `StudioAppPlugin` itself.
+
+```typescript
+import { StudioAppPlugin } from '@objectstack/studio';
+```
+
+Documentation: [Apps](https://objectstack.ai/docs/ui/apps)

packages/apps/studio/package.json

@@ -3,13 +3,20 @@
   "version": "18.1.0",
   "license": "Apache-2.0",
   "description": "ObjectStack Studio — the metadata builder app, packaged as its own ObjectStack app package (ADR-0048: one app per package).",
+  "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
     }
   },
   "scripts": {
@@ -34,7 +41,7 @@
   "author": "ObjectStack",
   "repository": {
     "type": "git",
-    "url": "https://github.com/objectstack-ai/objectstack.git",
+    "url": "git+https://github.com/objectstack-ai/objectstack.git",
     "directory": "packages/apps/studio"
   },
   "homepage": "https://objectstack.ai/docs",

packages/cli/package.json

@@ -4,6 +4,7 @@
   "description": "Command Line Interface for ObjectStack Protocol",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -141,7 +142,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/objectstack-ai/objectstack.git",
+    "url": "git+https://github.com/objectstack-ai/objectstack.git",
     "directory": "packages/cli"
   },
   "homepage": "https://objectstack.ai/docs",

packages/client-react/package.json

@@ -3,13 +3,20 @@
   "version": "18.1.0",
   "license": "Apache-2.0",
   "description": "React hooks for ObjectStack Client SDK",
+  "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
     }
   },
   "scripts": {
@@ -46,7 +53,7 @@
   "author": "ObjectStack",
   "repository": {
     "type": "git",
-    "url": "https://github.com/objectstack-ai/objectstack.git",
+    "url": "git+https://github.com/objectstack-ai/objectstack.git",
     "directory": "packages/client-react"
   },
   "homepage": "https://objectstack.ai/docs",

packages/client/package.json

@@ -3,13 +3,20 @@
   "version": "18.1.0",
   "license": "Apache-2.0",
   "description": "Official Client SDK for ObjectStack Protocol",
+  "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
     }
   },
   "scripts": {
@@ -53,7 +60,7 @@
   "author": "ObjectStack",
   "repository": {
     "type": "git",
-    "url": "https://github.com/objectstack-ai/objectstack.git",
+    "url": "git+https://github.com/objectstack-ai/objectstack.git",
     "directory": "packages/client"
   },
   "homepage": "https://objectstack.ai/docs",

packages/cloud-connection/package.json

@@ -6,6 +6,7 @@
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
       "import": {
@@ -50,7 +51,7 @@
   "author": "ObjectStack",
   "repository": {
     "type": "git",
-    "url": "https://github.com/objectstack-ai/objectstack.git",
+    "url": "git+https://github.com/objectstack-ai/objectstack.git",
     "directory": "packages/cloud-connection"
   },
   "homepage": "https://objectstack.ai/docs",