@ixo/topic-protocol 1.0.0-rc.4 → 1.0.0-rc.6

package/dist/src/v2/project.js

@@ -0,0 +1,268 @@
+import { TopicProtocolError } from "../errors.js";
+import { compareText } from "../shared/compare.js";
+import { canonicalJsonV2, sha256V2 } from "./canonical.js";
+import { TOPIC_KINDS_V2 } from "./types.js";
+function initialDraft(manifest) {
+    return {
+        title: manifest.title,
+        status: "open",
+        owner: manifest.owner,
+        due: manifest.due,
+        intent: manifest.intent,
+        outcome: manifest.outcome,
+        blocked: undefined,
+        flow: undefined,
+        links: [],
+        files: [],
+        relations: [],
+        records: [],
+        superseded: new Set(),
+        updatedBy: manifest.createdBy,
+        updatedAt: manifest.createdAt,
+        rejected: [],
+    };
+}
+function entryId(entry) {
+    return entry.value.id;
+}
+function instant(value) {
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? Number.POSITIVE_INFINITY : parsed;
+}
+/** Orders by normalised instant, then identifier in byte order, then canonical content so equal keys never depend on arrival order. */
+function compareEntries(left, right) {
+    return instant(left.value.createdAt) - instant(right.value.createdAt)
+        || compareText(entryId(left), entryId(right))
+        || compareText(canonicalJsonV2(left.value), canonicalJsonV2(right.value));
+}
+/** Identifiers that appear with more than one distinct payload. Every entry carrying such an identifier is rejected. */
+function conflictingIds(entries) {
+    const payloads = new Map();
+    const conflicts = new Set();
+    for (const entry of entries) {
+        const id = entryId(entry);
+        const payload = canonicalJsonV2(entry.value);
+        const known = payloads.get(id);
+        if (known === undefined)
+            payloads.set(id, payload);
+        else if (known !== payload)
+            conflicts.add(id);
+    }
+    return conflicts;
+}
+function orderedEntries(input) {
+    const entries = [
+        ...input.operations.map((value) => ({ kind: "operation", value })),
+        ...input.records.map((value) => ({ kind: "record", value })),
+    ];
+    return entries.sort(compareEntries);
+}
+function sameRef(left, right) {
+    return left.type === right.type && left.id === right.id;
+}
+function sameFile(file, resource, fileId) {
+    return file.resource === resource && file.fileId === fileId;
+}
+function sameRelation(entry, target) {
+    return entry.relation === target.relation && entry.topicId === target.targetTopicId;
+}
+function applyUpdate(draft, fields) {
+    if (fields.title !== undefined)
+        draft.title = fields.title;
+    if (fields.owner !== undefined)
+        draft.owner = fields.owner ?? undefined;
+    if (fields.due !== undefined)
+        draft.due = fields.due ?? undefined;
+    if (fields.intent !== undefined)
+        draft.intent = fields.intent ?? undefined;
+    if (fields.outcome !== undefined)
+        draft.outcome = fields.outcome ?? undefined;
+}
+function applyStatus(draft, status) {
+    draft.status = status;
+    if (status === "done" || status === "dropped")
+        draft.blocked = undefined;
+}
+function applyGraph(draft, operation) {
+    switch (operation.type) {
+        case "link":
+            if (!draft.links.some((ref) => sameRef(ref, operation.ref)))
+                draft.links.push(operation.ref);
+            return;
+        case "unlink":
+            draft.links = draft.links.filter((ref) => !sameRef(ref, operation.ref));
+            return;
+        case "attach":
+            draft.files = [
+                ...draft.files.filter((file) => !sameFile(file, operation.file.resource, operation.file.fileId)),
+                operation.file,
+            ];
+            return;
+        case "detach":
+            draft.files = draft.files.filter((file) => !sameFile(file, operation.resource, operation.fileId));
+            return;
+        case "relate":
+            if (!draft.relations.some((item) => sameRelation(item, operation))) {
+                draft.relations.push({ relation: operation.relation, topicId: operation.targetTopicId, by: operation.actor, at: operation.createdAt });
+            }
+            return;
+        case "unrelate":
+            draft.relations = draft.relations.filter((item) => !sameRelation(item, operation));
+            return;
+        default:
+            return;
+    }
+}
+function applyOperation(draft, operation) {
+    switch (operation.type) {
+        case "update":
+            applyUpdate(draft, operation.fields);
+            return;
+        case "set-status":
+            applyStatus(draft, operation.status);
+            return;
+        case "block":
+            draft.blocked = {
+                reason: operation.reason,
+                ...(operation.on === undefined ? {} : { on: operation.on }),
+                by: operation.actor,
+                since: operation.createdAt,
+            };
+            return;
+        case "unblock":
+            draft.blocked = undefined;
+            return;
+        case "bind-flow":
+            draft.flow = { flowUri: operation.flowUri, by: operation.actor, at: operation.createdAt };
+            return;
+        case "unbind-flow":
+            draft.flow = undefined;
+            return;
+        default:
+            applyGraph(draft, operation);
+    }
+}
+function applyRecord(draft, record) {
+    if (record.supersedes !== undefined) {
+        const target = draft.records.find((item) => item.id === record.supersedes && item.type === record.type);
+        if (target === undefined)
+            return "unknown-supersedes";
+        draft.superseded.add(target.id);
+    }
+    draft.records.push(record);
+    return undefined;
+}
+function admissionFor(entries, topicId, authorize) {
+    const verdicts = new Map();
+    for (const entry of entries) {
+        if (entry.value.topicId !== topicId)
+            verdicts.set(entry, "topic-mismatch");
+        else if (!authorize(entry))
+            verdicts.set(entry, "unauthorized");
+    }
+    const admissible = entries.filter((entry) => !verdicts.has(entry));
+    return { verdicts, conflicts: conflictingIds(admissible), seen: new Set() };
+}
+function rejectionFor(draft, entry, admission) {
+    const verdict = admission.verdicts.get(entry);
+    if (verdict !== undefined)
+        return verdict;
+    const id = entryId(entry);
+    if (admission.conflicts.has(id))
+        return "conflict";
+    if (admission.seen.has(id))
+        return "duplicate";
+    const reason = entry.kind === "record" ? applyRecord(draft, entry.value) : undefined;
+    if (reason === undefined)
+        admission.seen.add(id);
+    return reason;
+}
+function applyEntry(draft, entry, reason) {
+    if (reason !== undefined) {
+        draft.rejected.push({ id: entryId(entry), reason });
+        return;
+    }
+    if (entry.kind === "operation")
+        applyOperation(draft, entry.value);
+    draft.updatedBy = entry.kind === "operation" ? entry.value.actor : entry.value.author;
+    draft.updatedAt = entry.value.createdAt;
+}
+function currentRecords(draft) {
+    const live = draft.records.filter((record) => !draft.superseded.has(record.id));
+    return {
+        decisions: live.filter((record) => record.type === "decision"),
+        outcomes: live.filter((record) => record.type === "outcome"),
+        artifacts: live.filter((record) => record.type === "artifact"),
+        receipts: live.filter((record) => record.type === "receipt"),
+    };
+}
+function isBaseKind(value) {
+    return TOPIC_KINDS_V2.includes(value);
+}
+export function baseKindOf(manifest) {
+    if (isBaseKind(manifest.kind))
+        return manifest.kind;
+    return manifest.baseKind ?? "task";
+}
+function optional(key, value) {
+    return value === undefined ? {} : { [key]: value };
+}
+function finish(input, draft) {
+    const { manifest } = input;
+    const state = {
+        version: 2,
+        id: manifest.id,
+        anchor: input.anchor,
+        title: draft.title,
+        kind: manifest.kind,
+        baseKind: baseKindOf(manifest),
+        status: draft.status,
+        ...optional("owner", draft.owner),
+        ...optional("due", draft.due),
+        ...optional("intent", draft.intent),
+        ...optional("outcome", draft.outcome),
+        ...optional("blocked", draft.blocked),
+        createdBy: manifest.createdBy,
+        createdAt: manifest.createdAt,
+        updatedBy: draft.updatedBy,
+        updatedAt: draft.updatedAt,
+        links: draft.links,
+        files: draft.files,
+        relations: draft.relations,
+        ...optional("flow", draft.flow),
+        records: currentRecords(draft),
+    };
+    return { ...state, etag: sha256V2(state), rejected: draft.rejected };
+}
+/** Recomputes the concurrency token from a projection; equal to `projection.etag` when the projection is untouched. */
+export function topicEtagV2(projection) {
+    const { etag, rejected, ...state } = projection;
+    void etag;
+    void rejected;
+    return sha256V2(state);
+}
+function requireAuthorize(input) {
+    const candidate = input.authorize;
+    if (typeof candidate === "function")
+        return candidate;
+    throw new TopicProtocolError("AUTHORIZATION_FAILED", "Protocol 2.0 projection requires an explicit authorize policy");
+}
+/**
+ * The only projector in Protocol 2.0. Folds a manifest, its operations, and
+ * its records into one deterministic projection. Ordering is by the createdAt
+ * instant, then identifier in byte order; later writes win per field. An
+ * identifier that appears with two different admissible payloads is a conflict
+ * and every admissible entry carrying it is rejected, whatever the arrival
+ * order. Entries that fail the topic or authorization check are rejected on
+ * their own and cannot create a conflict for anyone else.
+ */
+export function projectTopicV2(input) {
+    const authorize = requireAuthorize(input);
+    const draft = initialDraft(input.manifest);
+    const entries = orderedEntries(input);
+    const admission = admissionFor(entries, input.manifest.id, authorize);
+    for (const entry of entries)
+        applyEntry(draft, entry, rejectionFor(draft, entry, admission));
+    return finish(input, draft);
+}
+//# sourceMappingURL=project.js.map

package/dist/src/v2/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../src/v2/project.ts"],"names":[],"mappings":"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"}

package/dist/src/v2/types.d.ts

@@ -0,0 +1,195 @@
+export declare const TOPIC_KINDS_V2: readonly ["discussion", "question", "task", "project"];
+export declare const TOPIC_STATUSES_V2: readonly ["open", "active", "waiting", "done", "dropped"];
+export declare const TOPIC_RECORD_TYPES_V2: readonly ["decision", "outcome", "artifact", "receipt"];
+export declare const TOPIC_RELATIONS_V2: readonly ["branches_from", "merged_into", "redirects_to", "references"];
+export declare const TOPIC_OPERATION_TYPES_V2: readonly ["update", "set-status", "block", "unblock", "link", "unlink", "attach", "detach", "relate", "unrelate", "bind-flow", "unbind-flow"];
+export type TopicBaseKindV2 = (typeof TOPIC_KINDS_V2)[number];
+export type TopicStatusV2 = (typeof TOPIC_STATUSES_V2)[number];
+export type TopicRecordTypeV2 = (typeof TOPIC_RECORD_TYPES_V2)[number];
+export type TopicRelationV2 = (typeof TOPIC_RELATIONS_V2)[number];
+export type TopicOperationTypeV2 = (typeof TOPIC_OPERATION_TYPES_V2)[number];
+export interface TopicRefV2 {
+    readonly type: string;
+    readonly id: string;
+}
+export interface TopicFileV2 {
+    readonly provider: "ixo.vfs";
+    readonly resource: string;
+    readonly fileId: string;
+    readonly version: number;
+    readonly cid: string;
+    readonly name: string;
+    readonly mimeType?: string;
+    readonly size?: number;
+}
+export interface TopicAnchorV2 {
+    readonly roomId: string;
+    readonly rootEventId: string;
+}
+export interface TopicBlockV2 {
+    readonly reason: string;
+    readonly on?: string;
+    readonly by: string;
+    readonly since: string;
+}
+/** Optional descriptive fields shared by the manifest and the projection. */
+export interface TopicOptionalFieldsV2 {
+    readonly owner?: string;
+    readonly due?: string;
+    readonly intent?: string;
+    readonly outcome?: string;
+}
+/** Immutable root content. A new Topic is `open`; status lives in operations. */
+export interface TopicManifestV2 extends TopicOptionalFieldsV2 {
+    readonly version: 2;
+    readonly id: string;
+    readonly title: string;
+    readonly kind: string;
+    readonly baseKind?: TopicBaseKindV2;
+    readonly createdBy: string;
+    readonly createdAt: string;
+}
+export interface TopicUpdateFieldsV2 {
+    readonly title?: string;
+    readonly owner?: string | null;
+    readonly due?: string | null;
+    readonly intent?: string | null;
+    readonly outcome?: string | null;
+}
+interface OperationBaseV2 {
+    readonly version: 2;
+    readonly id: string;
+    readonly topicId: string;
+    readonly actor: string;
+    readonly createdAt: string;
+}
+export type TopicOperationV2 = OperationBaseV2 & ({
+    readonly type: "update";
+    readonly fields: TopicUpdateFieldsV2;
+} | {
+    readonly type: "set-status";
+    readonly status: TopicStatusV2;
+    readonly reason?: string;
+} | {
+    readonly type: "block";
+    readonly reason: string;
+    readonly on?: string;
+} | {
+    readonly type: "unblock";
+} | {
+    readonly type: "link";
+    readonly ref: TopicRefV2;
+} | {
+    readonly type: "unlink";
+    readonly ref: TopicRefV2;
+} | {
+    readonly type: "attach";
+    readonly file: TopicFileV2;
+} | {
+    readonly type: "detach";
+    readonly resource: string;
+    readonly fileId: string;
+} | {
+    readonly type: "relate";
+    readonly relation: TopicRelationV2;
+    readonly targetTopicId: string;
+} | {
+    readonly type: "unrelate";
+    readonly relation: TopicRelationV2;
+    readonly targetTopicId: string;
+} | {
+    readonly type: "bind-flow";
+    readonly flowUri: string;
+} | {
+    readonly type: "unbind-flow";
+});
+export interface TopicRecordV2 {
+    readonly version: 2;
+    readonly id: string;
+    readonly topicId: string;
+    readonly type: TopicRecordTypeV2;
+    readonly text: string;
+    readonly author: string;
+    readonly createdAt: string;
+    readonly refs?: readonly TopicRefV2[];
+    readonly data?: Readonly<Record<string, unknown>>;
+    readonly supersedes?: string;
+}
+export interface TopicRelationEntryV2 {
+    readonly relation: TopicRelationV2;
+    readonly topicId: string;
+    readonly by: string;
+    readonly at: string;
+}
+export interface TopicFlowV2 {
+    readonly flowUri: string;
+    readonly by: string;
+    readonly at: string;
+}
+export interface TopicRecordsV2 {
+    readonly decisions: readonly TopicRecordV2[];
+    readonly outcomes: readonly TopicRecordV2[];
+    readonly artifacts: readonly TopicRecordV2[];
+    readonly receipts: readonly TopicRecordV2[];
+}
+export type RejectedReasonV2 = "conflict" | "duplicate" | "topic-mismatch" | "unauthorized" | "unknown-supersedes";
+export interface RejectedEntryV2 {
+    readonly id: string;
+    readonly reason: RejectedReasonV2;
+}
+export interface TopicProjectionV2 extends TopicOptionalFieldsV2 {
+    readonly version: 2;
+    readonly id: string;
+    readonly anchor: TopicAnchorV2;
+    readonly title: string;
+    readonly kind: string;
+    readonly baseKind: TopicBaseKindV2;
+    readonly status: TopicStatusV2;
+    readonly blocked?: TopicBlockV2;
+    readonly createdBy: string;
+    readonly createdAt: string;
+    readonly updatedBy: string;
+    readonly updatedAt: string;
+    readonly links: readonly TopicRefV2[];
+    readonly files: readonly TopicFileV2[];
+    readonly relations: readonly TopicRelationEntryV2[];
+    readonly flow?: TopicFlowV2;
+    readonly records: TopicRecordsV2;
+    /** SHA-256 of the canonical projected state (everything except `etag` and `rejected`). Changes whenever any projected field changes; use as the optimistic-concurrency token. */
+    readonly etag: string;
+    readonly rejected: readonly RejectedEntryV2[];
+}
+export type TopicEntryV2 = {
+    readonly kind: "operation";
+    readonly value: TopicOperationV2;
+} | {
+    readonly kind: "record";
+    readonly value: TopicRecordV2;
+};
+/**
+ * Returns whether the actor may apply the entry. The host supplies this from
+ * whatever it can actually verify: Matrix sender identity and room power level
+ * at minimum, a role policy or UCAN check when one exists. It is required; a
+ * projection without a policy is refused rather than defaulting to allow.
+ */
+export type TopicAuthorizeV2 = (entry: TopicEntryV2) => boolean;
+export interface TopicProjectionInputV2 {
+    readonly manifest: TopicManifestV2;
+    readonly anchor: TopicAnchorV2;
+    readonly operations: readonly TopicOperationV2[];
+    readonly records: readonly TopicRecordV2[];
+    readonly authorize: TopicAuthorizeV2;
+}
+export interface TopicMessageV2 {
+    readonly eventId: string;
+    readonly sender: string;
+    readonly body: string;
+    readonly at: string;
+}
+export interface TopicCapsuleV2 {
+    readonly version: 2;
+    readonly topic: TopicProjectionV2;
+    readonly messages: readonly TopicMessageV2[];
+    readonly hint: string;
+}
+export {};

package/dist/src/v2/types.js

@@ -0,0 +1,19 @@
+export const TOPIC_KINDS_V2 = ["discussion", "question", "task", "project"];
+export const TOPIC_STATUSES_V2 = ["open", "active", "waiting", "done", "dropped"];
+export const TOPIC_RECORD_TYPES_V2 = ["decision", "outcome", "artifact", "receipt"];
+export const TOPIC_RELATIONS_V2 = ["branches_from", "merged_into", "redirects_to", "references"];
+export const TOPIC_OPERATION_TYPES_V2 = [
+    "update",
+    "set-status",
+    "block",
+    "unblock",
+    "link",
+    "unlink",
+    "attach",
+    "detach",
+    "relate",
+    "unrelate",
+    "bind-flow",
+    "unbind-flow",
+];
+//# sourceMappingURL=types.js.map

package/dist/src/v2/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/v2/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAC3F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAU,CAAC;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,CAAU,CAAC;AAC1G,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,SAAS;IACT,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,WAAW;IACX,aAAa;CACL,CAAC"}