@proofmeta/resolver-free 0.2.0

package/README.md

@@ -0,0 +1,43 @@
+# @proofmeta/resolver-free
+
+Reference "free" resolver for the [ProofMeta Protocol](https://github.com/bettabeta/proofmeta). No-op: confirms instantly, carries no external dependencies. Use it for Tier-1 flows, demos, and integration tests where no real payment or delivery is needed.
+
+## Install
+
+```
+npm install @proofmeta/resolver-free
+```
+
+## Use
+
+```js
+import { createFreeResolver } from "@proofmeta/resolver-free";
+
+const free = createFreeResolver({ id: "none" });
+
+// 1. Advertise it in your Manifest
+manifest.resolvers = [free.descriptor];
+// → { role: "payment", id: "none" }
+
+// 2. Invoke it when handling an OPEN license request
+const result = await free.process({ request, licenseType });
+// → { ok: true, receipt: { resolver: "free:none", confirmed_at: "..." } }
+```
+
+## Resolver interface
+
+The programming interface below is **not** part of the ProofMeta protocol on the wire — it's the shape the reference Provider (`examples/provider/server.mjs`) expects from a resolver module. Other Providers are free to invent their own calling convention; what matters on the wire is the `{ role, id }` entry in the Manifest and the resulting `status.update` envelopes.
+
+```ts
+{
+  descriptor: { role: "payment" | "delivery" | "anchor" | string, id: string },
+  process(ctx: { request, licenseType }): Promise<
+    { ok: true,  receipt?: Record<string, unknown> } |
+    { ok: false, reason:  string }
+  >
+}
+```
+
+## License
+
+Apache-2.0. See [LICENSE](https://github.com/bettabeta/proofmeta/blob/main/LICENSE).

package/index.mjs

@@ -0,0 +1,53 @@
+// Copyright 2026 Daud Zulfacar, Pandr UG (haftungsbeschränkt)
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * @proofmeta/resolver-free — no-op payment resolver.
+ *
+ * Declares itself as { role: "payment", id: "none" } (or a custom id the
+ * Provider chooses). Its `process` hook returns immediately with ok:true,
+ * carrying no external side effects. Used for Tier-1 flows and integration
+ * tests per Success Criterion #3.
+ *
+ * The programming interface below is NOT part of the protocol — it's the
+ * shape the reference Provider example expects a resolver module to expose.
+ * Other Providers are free to invent their own calling convention.
+ */
+
+/**
+ * @typedef {Object} ResolverDescriptor
+ * @property {"payment"|"delivery"|"anchor"|string} role
+ * @property {string} id
+ *
+ * @typedef {Object} ProcessResultOK
+ * @property {true} ok
+ * @property {Record<string, unknown>} [receipt]
+ *
+ * @typedef {Object} ProcessResultErr
+ * @property {false} ok
+ * @property {string} reason
+ *
+ * @typedef {ProcessResultOK|ProcessResultErr} ProcessResult
+ *
+ * @typedef {Object} ProcessContext
+ * @property {Object} request  The verified OPEN license.request payload
+ * @property {Object} licenseType  The Manifest license_types[] entry for this request
+ */
+
+/**
+ * Create a free resolver instance.
+ *
+ * @param {Object} [opts]
+ * @param {string} [opts.id="none"] — id as it will appear in Manifest.resolvers[].id
+ * @returns {{ descriptor: ResolverDescriptor, process: (ctx: ProcessContext) => Promise<ProcessResult> }}
+ */
+export function createFreeResolver(opts = {}) {
+  const id = opts.id ?? "none";
+  return {
+    descriptor: { role: "payment", id },
+    async process(_ctx) {
+      // No payment, no external call, no anchor. The license is free.
+      return { ok: true, receipt: { resolver: `free:${id}`, confirmed_at: new Date().toISOString() } };
+    },
+  };
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@proofmeta/resolver-free",
+  "version": "0.2.0",
+  "description": "ProofMeta reference resolver: no-op 'free' payment resolver. Instantly confirms; carries no external dependencies. Used for Tier-1 flows and integration tests.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./index.mjs",
+  "exports": {
+    ".": "./index.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "README.md"
+  ],
+  "keywords": [
+    "proofmeta",
+    "resolver",
+    "free",
+    "licensing",
+    "agents",
+    "ai",
+    "protocol"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bettabeta/proofmeta.git",
+    "directory": "packages/resolvers/free"
+  },
+  "homepage": "https://github.com/bettabeta/proofmeta#readme",
+  "bugs": {
+    "url": "https://github.com/bettabeta/proofmeta/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}