@fungi.computer/puffball 0.0.0-stage → 0.0.1

package/docs/api/publisher.md

@@ -0,0 +1,147 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/puffball**](README.md)
+
+---
+
+[@fungi.computer/puffball](README.md) / publisher
+
+# publisher
+
+## Type Aliases
+
+### TeamAppTemplateSeed
+
+```ts
+type TeamAppTemplateSeed = Readonly<{
+  appId: AppId;
+  revision: SourceRevision;
+}>;
+```
+
+Exact first-party platform seed from which a Team-owned App was forked.
+
+---
+
+### AppSourceRepository
+
+```ts
+type AppSourceRepository = Schema.Schema.Type<typeof appSourceRepositorySchema>;
+```
+
+Parsed immutable source location used to build one App.
+
+---
+
+### TeamAppPublisherRegistration
+
+```ts
+type TeamAppPublisherRegistration = Schema.Schema.Type<
+  typeof teamAppPublisherRegistrationSchema
+>;
+```
+
+Parsed Team ownership record for one App publisher.
+
+---
+
+### TeamAppPublisherRegistrationRead
+
+```ts
+type TeamAppPublisherRegistrationRead =
+  | Readonly<{
+      kind: "found";
+      registration: TeamAppPublisherRegistration;
+    }>
+  | Readonly<{
+      kind: "absent";
+    }>;
+```
+
+Result of reading the durable publisher registered for an App.
+
+---
+
+### TeamAppPublisherRegistrationCreate
+
+```ts
+type TeamAppPublisherRegistrationCreate =
+  | Readonly<{
+      kind: "created" | "existing";
+      registration: TeamAppPublisherRegistration;
+    }>
+  | Readonly<{
+      kind: "conflict";
+    }>;
+```
+
+Idempotent result of registering one App publisher.
+
+---
+
+### TeamAppPublicationAuthorization
+
+```ts
+type TeamAppPublicationAuthorization =
+  | Readonly<{
+      kind: "authorized";
+      registration: TeamAppPublisherRegistration;
+    }>
+  | Readonly<{
+      kind: "absent" | "denied";
+    }>;
+```
+
+Team-scoped decision for publishing a registered App.
+
+---
+
+### TeamAppPublisherRegistry
+
+```ts
+type TeamAppPublisherRegistry = Readonly<{
+  read: Promise<TeamAppPublisherRegistrationRead>;
+  register: Promise<TeamAppPublisherRegistrationCreate>;
+  authorize: Promise<TeamAppPublicationAuthorization>;
+}>;
+```
+
+Durable App publisher facts; Team membership remains owned by Hub.
+
+## Variables
+
+### appSourceRepositorySchema
+
+```ts
+const appSourceRepositorySchema: Struct<{
+  provider: Literals<readonly ["artifacts", "github"]>;
+  repository: String;
+  branch: Literal<"main">;
+}>;
+```
+
+Canonical source repository resolved by the product publisher.
+
+---
+
+### teamAppPublisherRegistrationSchema
+
+```ts
+const teamAppPublisherRegistrationSchema: Struct<{
+  appId: refine<AppId, String>;
+  teamId: String;
+  source: Struct<{
+    provider: Literals<readonly ["artifacts", "github"]>;
+    repository: String;
+    branch: Literal<"main">;
+  }>;
+  templateSeed: optionalKey<
+    Struct<{
+      appId: refine<AppId, String>;
+      revision: refine<SourceRevision, String>;
+    }>
+  >;
+}>;
+```
+
+Team-owned publication authority for one separately registered App.

package/docs/api/testing.md

@@ -0,0 +1,31 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/puffball**](README.md)
+
+---
+
+[@fungi.computer/puffball](README.md) / testing
+
+# testing
+
+## Functions
+
+### sqliteD1()
+
+```ts
+function sqliteD1(sqlite): AppReleaseD1Database;
+```
+
+Adapt caller-owned Node SQLite to the catalog's D1 transport for tests and quick
+starts. The caller applies schema and closes the database. This is not a
+Cloudflare emulator or an isolation boundary.
+
+#### Parameters
+
+| Parameter | Type           |
+| --------- | -------------- |
+| `sqlite`  | `DatabaseSync` |
+
+#### Returns
+
+[`AppReleaseD1Database`](cloudflare.md#appreleased1database)

package/package.json

@@ -1,6 +1,161 @@
 {
   "name": "@fungi.computer/puffball",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1",
+  "author": "Levi <levi@technomancy.dev>",
+  "description": "Immutable App/Release catalog with verified public website delivery",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./effect": {
+      "types": "./dist/effect.d.ts",
+      "import": "./dist/effect.js"
+    },
+    "./cloudflare": {
+      "types": "./dist/cloudflare.d.ts",
+      "import": "./dist/cloudflare.js"
+    },
+    "./app": {
+      "types": "./dist/app.d.ts",
+      "import": "./dist/app.js"
+    },
+    "./backend": {
+      "types": "./dist/backend.d.ts",
+      "import": "./dist/backend.js"
+    },
+    "./assets": {
+      "types": "./dist/assets.d.ts",
+      "import": "./dist/assets.js"
+    },
+    "./cloudflare-assets": {
+      "types": "./dist/cloudflare-assets.d.ts",
+      "import": "./dist/cloudflare-assets.js"
+    },
+    "./buyer-references": {
+      "types": "./dist/buyer-references.d.ts",
+      "import": "./dist/buyer-references.js"
+    },
+    "./safety-takedown": {
+      "types": "./dist/safety-takedown.d.ts",
+      "import": "./dist/safety-takedown.js"
+    },
+    "./public-route-moderation": {
+      "types": "./dist/public-route-moderation.d.ts",
+      "import": "./dist/public-route-moderation.js"
+    },
+    "./app-origin-paths": {
+      "types": "./dist/app-origin-paths.d.ts",
+      "import": "./dist/app-origin-paths.js"
+    },
+    "./public-routes": {
+      "types": "./dist/public-routes.d.ts",
+      "import": "./dist/public-routes.js"
+    },
+    "./public-route-policy": {
+      "types": "./dist/public-route-policy.d.ts",
+      "import": "./dist/public-route-policy.js"
+    },
+    "./publisher": {
+      "types": "./dist/publisher.d.ts",
+      "import": "./dist/publisher.js"
+    },
+    "./artifact-dispositions": {
+      "types": "./dist/artifact-dispositions.d.ts",
+      "import": "./dist/artifact-dispositions.js"
+    },
+    "./seller-closure-notice": {
+      "types": "./dist/seller-closure-notice.d.ts",
+      "import": "./dist/seller-closure-notice.js"
+    },
+    "./seller-closure": {
+      "types": "./dist/seller-closure.d.ts",
+      "import": "./dist/seller-closure.js"
+    },
+    "./app-method-runtime": {
+      "types": "./dist/app-method-runtime.d.ts",
+      "import": "./dist/app-method-runtime.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    },
+    "./git-representation": {
+      "types": "./dist/git-representation.d.ts",
+      "import": "./dist/git-representation.js"
+    },
+    "./app-event-facts": {
+      "types": "./dist/app-event-facts.d.ts",
+      "import": "./dist/app-event-facts.js"
+    },
+    "./inbox": {
+      "types": "./dist/inbox.d.ts",
+      "import": "./dist/inbox.js"
+    },
+    "./background-replay": {
+      "types": "./dist/background-replay.d.ts",
+      "import": "./dist/background-replay.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs/api",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@fungi.computer/cairn": "0.0.1",
+    "effect": "4.0.2",
+    "@fungi.computer/cloudflare-worker-bundler": "0.2.3-fungi.0",
+    "zod": "4.4.3",
+    "@fungi.computer/watchdog": "0.0.1",
+    "@fungi.computer/gills": "0.0.1"
+  },
+  "devDependencies": {
+    "@cloudflare/vitest-plugin": "1.1.2",
+    "@types/node": "24.13.3",
+    "typescript": "5.9.3",
+    "vitest": "4.1.11",
+    "@cloudflare/workers-types": "5.20260828.1"
+  },
+  "botanical": {
+    "role": "package",
+    "operations": {
+      "lint": "required",
+      "typecheck": "required",
+      "build": "required",
+      "test": "required",
+      "docs": "required",
+      "pack": "required",
+      "smoke": "required",
+      "stranger": "required"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fungi-computer/puffball.git"
+  },
+  "scripts": {
+    "lint": "eslint --global URL --global TextEncoder src test examples --max-warnings=0 && ../../node_modules/.bin/oxlint --config ../../oxlint.config.ts --deny-warnings src test examples",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "pnpm run clean && tsc -p tsconfig.build.json",
+    "clean": "node --input-type=module --eval \"import { rm } from 'node:fs/promises'; await rm('dist', { recursive: true, force: true });\"",
+    "test": "vitest run --config vitest.node.config.ts && vitest run --config vitest.cloudflare.config.ts && vitest run --config vitest.cloudflare.restart.config.ts && vitest run --config vitest.cloudflare.transition.config.ts && vitest run --config vitest.cloudflare.transition-storage.config.ts && vitest run --config vitest.cloudflare.transition-lifecycle.config.ts && vitest run --config vitest.cloudflare.transition-idempotency.config.ts && vitest run --config vitest.cloudflare.a1-2.config.ts && vitest run --config vitest.cloudflare.public-routes.config.ts",
+    "test:cloudflare": "../../node_modules/.bin/vitest run --config vitest.cloudflare.config.ts && ../../node_modules/.bin/vitest run --config vitest.cloudflare.restart.config.ts && ../../node_modules/.bin/vitest run --config vitest.cloudflare.transition.config.ts && ../../node_modules/.bin/vitest run --config vitest.cloudflare.transition-storage.config.ts && ../../node_modules/.bin/vitest run --config vitest.cloudflare.transition-lifecycle.config.ts && ../../node_modules/.bin/vitest run --config vitest.cloudflare.transition-idempotency.config.ts && ../../node_modules/.bin/vitest run --config vitest.cloudflare.a1-2.config.ts && ../../node_modules/.bin/vitest run --config vitest.cloudflare.public-routes.config.ts",
+    "docs": "tsx ../../tooling/repository/src/docs/cli.ts check --root ../..",
+    "docs:write": "tsx ../../tooling/repository/src/docs/cli.ts write --root ../..",
+    "pack": "mkdir -p ../../.botanical/puffball-pack && pnpm pack --pack-destination ../../.botanical/puffball-pack",
+    "smoke": "node --input-type=module -e \"import('./dist/index.js').then(({createAppReleaseCatalog}) => { if (typeof createAppReleaseCatalog !== 'function') process.exit(1); })\"",
+    "stranger": "tsx ../../tooling/repository/src/artifacts/cli.ts --repo-root ../.. .",
+    "demo:a1.2": "node --import tsx examples/a1-2-public-website.ts",
+    "demo:a1.2:self-check": "node --import tsx examples/a1-2-public-website.ts --self-check",
+    "format:check": "node ../../tooling/repository/scripts/format-package-check.mjs",
+    "lint:anti-slop": "node ../../tooling/repository/scripts/lint-package-anti-slop.mjs",
+    "test:unit": "../../node_modules/.bin/vitest run --config vitest.node.config.ts",
+    "test:merge": "pnpm run test:cloudflare"
+  }
 }