@inhuman.tools/plexus-expectations 0.1.0 → 0.3.0

package/dist/shared/resolution.js

@@ -1,124 +0,0 @@
-/**
- * Resolution request / answer shapes. Separate from ordinary TProposal steer.
- * Transport lives on dedicated awareness lanes; parse functions drop junk.
- */
-export function parseProposalOption(raw) {
-    let result = null;
-    if (raw != null && typeof raw === "object") {
-        const value = raw.value;
-        if (typeof value === "string" && value !== "") {
-            const label = raw.label;
-            result = typeof label === "string" && label !== "" ? { value, label } : { value };
-        }
-    }
-    return result;
-}
-/** Untrusted awareness field → published ask, or null. */
-export function parseResolutionRequest(raw) {
-    let result = null;
-    if (raw != null && typeof raw === "object") {
-        const o = raw;
-        if (typeof o.requestId === "string" &&
-            o.requestId !== "" &&
-            typeof o.type === "string" &&
-            typeof o.description === "string" &&
-            o.description.trim() !== "" &&
-            Array.isArray(o.options) &&
-            o.options.length > 0) {
-            const options = [];
-            const seen = new Set();
-            let valid = true;
-            for (const item of o.options) {
-                const option = parseProposalOption(item);
-                if (option === null || seen.has(option.value)) {
-                    valid = false;
-                    break;
-                }
-                seen.add(option.value);
-                options.push(option);
-            }
-            const defaults = parseDefaults(o.defaults, seen);
-            if (valid && (o.defaults === undefined || defaults !== undefined)) {
-                result = {
-                    requestId: o.requestId,
-                    type: o.type,
-                    description: o.description,
-                    options,
-                    body: o.body,
-                    defaults,
-                };
-            }
-        }
-    }
-    return result;
-}
-/** Untrusted awareness field → answer, or null. Missing `requestId` is ignored (no front-run). */
-export function parseResolution(raw) {
-    let result = null;
-    if (raw != null && typeof raw === "object") {
-        const value = raw.value;
-        const requestId = raw.requestId;
-        if (typeof value === "string" && value !== "" && typeof requestId === "string" && requestId !== "") {
-            result = { requestId, value };
-        }
-    }
-    return result;
-}
-export function normalizeProposalRequest(request) {
-    if (typeof request.type !== "string") {
-        throw new TypeError("proposal request type must be a string");
-    }
-    if (typeof request.description !== "string" || request.description.trim() === "") {
-        throw new Error("proposal request description is required");
-    }
-    if (!Array.isArray(request.options) || request.options.length === 0) {
-        throw new Error("proposal request options must be a non-empty list");
-    }
-    const options = [];
-    const seen = new Set();
-    for (const item of request.options) {
-        const option = parseProposalOption(item);
-        if (option == null)
-            throw new Error("proposal request option value must be a non-empty string");
-        if (seen.has(option.value))
-            throw new Error(`proposal request option value repeats: ${option.value}`);
-        seen.add(option.value);
-        options.push(option);
-    }
-    const defaults = parseDefaults(request.defaults, seen);
-    if (request.defaults !== undefined && defaults === undefined) {
-        throw new Error("proposal request defaults must name option values");
-    }
-    return {
-        type: request.type,
-        description: request.description,
-        options,
-        body: request.body,
-        defaults,
-    };
-}
-function parseDefaults(raw, values) {
-    let result;
-    if (raw != null && typeof raw === "object") {
-        const confirm = raw.confirm;
-        const brk = raw.break;
-        const out = {};
-        let valid = true;
-        if (confirm !== undefined) {
-            if (typeof confirm === "string" && values.has(confirm))
-                out.confirm = confirm;
-            else
-                valid = false;
-        }
-        if (brk !== undefined) {
-            if (typeof brk === "string" && values.has(brk))
-                out.break = brk;
-            else
-                valid = false;
-        }
-        if (valid && Object.keys(out).length > 0)
-            result = out;
-    }
-    return result;
-}
-//# sourceMappingURL=resolution.js.map

package/dist/shared/resolution.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolution.js","sourceRoot":"","sources":["../../src/shared/resolution.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resolution request / answer shapes. Separate from ordinary TProposal steer.\n * Transport lives on dedicated awareness lanes; parse functions drop junk.\n */\n\n/** One choosable value. `label` is display; identity is `value`. */\nexport type ProposalOption = {\n  readonly value: string;\n  readonly label?: string;\n};\n\n/**\n * Actor → world ask. Default path is `description` + `options` + `defaults`.\n * `type` / `body` are optional enrichment — unknown `type` is ignored, not rejected.\n */\nexport type ProposalRequest = {\n  readonly type: string;\n  readonly description: string;\n  readonly body?: unknown;\n  readonly options: readonly ProposalOption[];\n  readonly defaults?: {\n    readonly confirm?: string;\n    readonly break?: string;\n  };\n};\n\n/** Published ask — {@link ProposalRequest} plus the request id on the resolution-request lane. */\nexport type ResolutionRequest = ProposalRequest & {\n  readonly requestId: string;\n};\n\n/** Author → actor answer on the resolution lane. */\nexport type Resolution = {\n  readonly requestId: string;\n  readonly value: string;\n};\n\nexport function parseProposalOption(raw: unknown): ProposalOption | null {\n  let result: ProposalOption | null = null;\n  if (raw != null && typeof raw === \"object\") {\n    const value = (raw as { value?: unknown }).value;\n    if (typeof value === \"string\" && value !== \"\") {\n      const label = (raw as { label?: unknown }).label;\n      result = typeof label === \"string\" && label !== \"\" ? { value, label } : { value };\n    }\n  }\n  return result;\n}\n\n/** Untrusted awareness field → published ask, or null. */\nexport function parseResolutionRequest(raw: unknown): ResolutionRequest | null {\n  let result: ResolutionRequest | null = null;\n  if (raw != null && typeof raw === \"object\") {\n    const o = raw as Record<string, unknown>;\n    if (\n      typeof o.requestId === \"string\" &&\n      o.requestId !== \"\" &&\n      typeof o.type === \"string\" &&\n      typeof o.description === \"string\" &&\n      o.description.trim() !== \"\" &&\n      Array.isArray(o.options) &&\n      o.options.length > 0\n    ) {\n      const options: ProposalOption[] = [];\n      const seen = new Set<string>();\n      let valid = true;\n      for (const item of o.options) {\n        const option = parseProposalOption(item);\n        if (option === null || seen.has(option.value)) {\n          valid = false;\n          break;\n        }\n        seen.add(option.value);\n        options.push(option);\n      }\n      const defaults = parseDefaults(o.defaults, seen);\n      if (valid && (o.defaults === undefined || defaults !== undefined)) {\n        result = {\n          requestId: o.requestId,\n          type: o.type,\n          description: o.description,\n          options,\n          body: o.body,\n          defaults,\n        };\n      }\n    }\n  }\n  return result;\n}\n\n/** Untrusted awareness field → answer, or null. Missing `requestId` is ignored (no front-run). */\nexport function parseResolution(raw: unknown): Resolution | null {\n  let result: Resolution | null = null;\n  if (raw != null && typeof raw === \"object\") {\n    const value = (raw as { value?: unknown }).value;\n    const requestId = (raw as { requestId?: unknown }).requestId;\n    if (typeof value === \"string\" && value !== \"\" && typeof requestId === \"string\" && requestId !== \"\") {\n      result = { requestId, value };\n    }\n  }\n  return result;\n}\n\nexport function normalizeProposalRequest(request: ProposalRequest): ProposalRequest {\n  if (typeof request.type !== \"string\") {\n    throw new TypeError(\"proposal request type must be a string\");\n  }\n  if (typeof request.description !== \"string\" || request.description.trim() === \"\") {\n    throw new Error(\"proposal request description is required\");\n  }\n  if (!Array.isArray(request.options) || request.options.length === 0) {\n    throw new Error(\"proposal request options must be a non-empty list\");\n  }\n  const options: ProposalOption[] = [];\n  const seen = new Set<string>();\n  for (const item of request.options) {\n    const option = parseProposalOption(item);\n    if (option == null) throw new Error(\"proposal request option value must be a non-empty string\");\n    if (seen.has(option.value)) throw new Error(`proposal request option value repeats: ${option.value}`);\n    seen.add(option.value);\n    options.push(option);\n  }\n  const defaults = parseDefaults(request.defaults, seen);\n  if (request.defaults !== undefined && defaults === undefined) {\n    throw new Error(\"proposal request defaults must name option values\");\n  }\n  return {\n    type: request.type,\n    description: request.description,\n    options,\n    body: request.body,\n    defaults,\n  };\n}\n\nfunction parseDefaults(\n  raw: unknown,\n  values: ReadonlySet<string>,\n): { readonly confirm?: string; readonly break?: string } | undefined {\n  let result: { readonly confirm?: string; readonly break?: string } | undefined;\n  if (raw != null && typeof raw === \"object\") {\n    const confirm = (raw as { confirm?: unknown }).confirm;\n    const brk = (raw as { break?: unknown }).break;\n    const out: { confirm?: string; break?: string } = {};\n    let valid = true;\n    if (confirm !== undefined) {\n      if (typeof confirm === \"string\" && values.has(confirm)) out.confirm = confirm;\n      else valid = false;\n    }\n    if (brk !== undefined) {\n      if (typeof brk === \"string\" && values.has(brk)) out.break = brk;\n      else valid = false;\n    }\n    if (valid && Object.keys(out).length > 0) result = out;\n  }\n  return result;\n}\n"]}