@xnetjs/data 0.0.2 → 0.1.0

package/dist/chunk-UQM3G5A2.js

@@ -0,0 +1,148 @@
+import {
+  spaceCascadeAuthorization
+} from "./chunk-OCMSAKWV.js";
+import {
+  checkbox,
+  date,
+  defineSchema,
+  person,
+  relation,
+  select,
+  text
+} from "./chunk-EBNMV2VO.js";
+
+// src/schema/schemas/task.ts
+var TaskSchema = defineSchema({
+  name: "Task",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Task title */
+    title: text({ required: true, maxLength: 500 }),
+    /**
+     * Human-readable identifier, e.g. "XN-142". Allocated from hub-issued
+     * per-device blocks (see task-identifiers.ts) so offline mints never
+     * collide. Pattern-matched in branch names / commit messages / PR text
+     * by the GitHub integration.
+     */
+    shortId: text({ maxLength: 20 }),
+    /** Whether the task is completed */
+    completed: checkbox({ default: false }),
+    /**
+     * Task workflow status.
+     *
+     * Statuses belong to categories (TASK_STATUS_CATEGORIES); `completed`
+     * is derivable from the category (isCompletedTaskStatus) so checkboxes
+     * stay one-tap everywhere. The original four statuses are unchanged;
+     * triage/backlog/in-review are additive (no version bump needed).
+     */
+    status: select({
+      options: [
+        { id: "triage", name: "Triage", color: "yellow" },
+        { id: "backlog", name: "Backlog", color: "gray" },
+        { id: "todo", name: "To Do", color: "gray" },
+        { id: "in-progress", name: "In Progress", color: "blue" },
+        { id: "in-review", name: "In Review", color: "green" },
+        { id: "done", name: "Done", color: "green" },
+        { id: "cancelled", name: "Cancelled", color: "red" }
+      ],
+      default: "todo"
+    }),
+    /** Task priority */
+    priority: select({
+      options: [
+        { id: "low", name: "Low", color: "gray" },
+        { id: "medium", name: "Medium", color: "yellow" },
+        { id: "high", name: "High", color: "orange" },
+        { id: "urgent", name: "Urgent", color: "red" }
+      ],
+      default: "medium"
+    }),
+    /** Due date */
+    dueDate: date({}),
+    /** Assigned person (legacy single assignee for compatibility) */
+    assignee: person({}),
+    /** Assigned people */
+    assignees: person({ multiple: true }),
+    /** Parent task (for subtasks) */
+    parent: relation({ target: "xnet://xnet.fyi/Task" }),
+    /** Project this task belongs to */
+    project: relation({ target: "xnet://xnet.fyi/Project@1.0.0" }),
+    /** Milestone within the project this task targets (one per task) */
+    milestone: relation({ target: "xnet://xnet.fyi/Milestone@1.0.0" }),
+    /** Page that currently hosts this task */
+    page: relation({ target: "xnet://xnet.fyi/Page@1.0.0" }),
+    /** Canvas that currently hosts this task (canvas-sourced tasks) */
+    canvas: relation({ target: "xnet://xnet.fyi/Canvas@1.0.0" }),
+    /** Surface-specific anchor: block id inside the page document, or the
+     * hosting canvas object id for canvas-sourced tasks */
+    anchorBlockId: text({ maxLength: 500 }),
+    /** Stable sibling order key for cross-view projections */
+    sortKey: text({ maxLength: 500 }),
+    /** Workspace-wide labels, referenced by id (exploration 0169) */
+    tags: relation({ target: "xnet://xnet.fyi/Tag@1.0.0", multiple: true }),
+    /** Where this task was created */
+    source: select({
+      options: [
+        { id: "page", name: "Page" },
+        { id: "database", name: "Database" },
+        { id: "canvas", name: "Canvas" },
+        { id: "automation", name: "Automation" },
+        { id: "api", name: "API" }
+      ],
+      default: "page"
+    }),
+    /** Structured external references related to this task */
+    references: relation({
+      target: "xnet://xnet.fyi/ExternalReference@1.0.0",
+      multiple: true
+    }),
+    /** Canonical folder home for uniform filing; empty = Unfiled (0190) */
+    folder: relation({ target: "xnet://xnet.fyi/Folder@1.0.0" }),
+    /**
+     * Optional habit/metric this task tracks — completing the task can log an
+     * observation against the metric (cross-domain integration, 0190).
+     */
+    metric: relation({ target: "xnet://xnet.fyi/Metric@1.0.0" }),
+    /** Optional experiment this task belongs to (cross-domain, 0190). */
+    experiment: relation({ target: "xnet://xnet.fyi/Experiment@1.0.0" }),
+    /** Canonical SECURITY home; empty = personal/private (exploration 0179) */
+    space: relation({ target: "xnet://xnet.fyi/Space@1.0.0" }),
+    /** Per-node visibility; `inherit` defers to the Space (exploration 0179) */
+    visibility: select({
+      options: [
+        { id: "inherit", name: "Inherit", color: "gray" },
+        { id: "private", name: "Private", color: "gray" },
+        { id: "unlisted", name: "Unlisted", color: "yellow" },
+        { id: "public", name: "Public", color: "green" }
+      ],
+      default: "inherit"
+    })
+  },
+  document: "yjs",
+  // Collaborative Y.Doc for description
+  // Inherits access from its home Space (exploration 0181).
+  authorization: spaceCascadeAuthorization()
+});
+var TASK_STATUS_CATEGORIES = {
+  triage: "triage",
+  backlog: "backlog",
+  todo: "unstarted",
+  "in-progress": "started",
+  "in-review": "started",
+  done: "completed",
+  cancelled: "cancelled"
+};
+function getTaskStatusCategory(status) {
+  return TASK_STATUS_CATEGORIES[status ?? "todo"] ?? "unstarted";
+}
+function isCompletedTaskStatus(status) {
+  const category = getTaskStatusCategory(status);
+  return category === "completed" || category === "cancelled";
+}
+
+export {
+  TaskSchema,
+  TASK_STATUS_CATEGORIES,
+  getTaskStatusCategory,
+  isCompletedTaskStatus
+};

package/dist/chunk-VQ7JHB67.js

@@ -0,0 +1,57 @@
+import {
+  spaceCascadeAuthorization
+} from "./chunk-OCMSAKWV.js";
+import {
+  date,
+  defineSchema,
+  number,
+  relation,
+  select,
+  text
+} from "./chunk-EBNMV2VO.js";
+
+// src/schema/schemas/import-batch.ts
+var IMPORT_BATCH_SCHEMA_IRI = "xnet://xnet.fyi/ImportBatch@1.0.0";
+var ImportBatchSchema = defineSchema({
+  name: "ImportBatch",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Where the rows came from. */
+    source: select({
+      options: [
+        { id: "csv", name: "CSV" },
+        { id: "ofx", name: "OFX / QFX" },
+        { id: "qif", name: "QIF" },
+        { id: "bank", name: "Bank sync" },
+        { id: "manual", name: "Manual" }
+      ],
+      default: "csv"
+    }),
+    /** Original file name, if any. */
+    filename: text({ maxLength: 500 }),
+    /** When the import ran (Unix ms). */
+    importedAt: date({ required: true }),
+    /** The account the statement was imported into. */
+    account: relation({ target: "xnet://xnet.fyi/Account@1.0.0" }),
+    /** Number of transactions created in this batch. */
+    count: number({ integer: true, min: 0 }),
+    /** Canonical SECURITY home; empty = personal/private book (0179/0181). */
+    space: relation({ target: "xnet://xnet.fyi/Space@1.0.0" }),
+    /** Per-node visibility; defaults to `private` (financial data, 0187). */
+    visibility: select({
+      options: [
+        { id: "inherit", name: "Inherit", color: "gray" },
+        { id: "private", name: "Private", color: "gray" },
+        { id: "unlisted", name: "Unlisted", color: "yellow" },
+        { id: "public", name: "Public", color: "green" }
+      ],
+      default: "private"
+    })
+  },
+  authorization: spaceCascadeAuthorization()
+});
+
+export {
+  IMPORT_BATCH_SCHEMA_IRI,
+  ImportBatchSchema
+};

package/dist/chunk-W7EBL7ZU.js

@@ -0,0 +1,73 @@
+import {
+  spaceCascadeAuthorization
+} from "./chunk-OCMSAKWV.js";
+import {
+  date,
+  defineSchema,
+  json,
+  number,
+  relation,
+  select,
+  text
+} from "./chunk-EBNMV2VO.js";
+
+// src/schema/schemas/observation.ts
+var ObservationSchema = defineSchema({
+  name: "Observation",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** The metric this datapoint measures. */
+    metric: relation({ target: "xnet://xnet.fyi/Metric@1.0.0", required: true }),
+    /**
+     * Canonical day — UTC midnight ms of the calendar day (see
+     * @xnetjs/experiments `canonicalDay`). One observation per day per metric is
+     * the norm; using `date()` gives date-aware filters + calendar binding.
+     */
+    day: date({ required: true }),
+    /** Measured value. Booleans encode 1 (done) / 0 (not). */
+    value: number({ required: true }),
+    /** Free-text note for the datapoint (qualitative context). */
+    note: text({ maxLength: 2e3 }),
+    /** Stamped from the experiment's active phase at entry time. */
+    phase: select({
+      options: [
+        { id: "none", name: "None" },
+        { id: "baseline", name: "Baseline" },
+        { id: "intervention", name: "Intervention" },
+        { id: "washout", name: "Washout" }
+      ],
+      default: "none"
+    }),
+    /** Where the value came from. */
+    source: select({
+      options: [
+        { id: "manual", name: "Manual" },
+        { id: "sensor", name: "Sensor" },
+        { id: "import", name: "Import" }
+      ],
+      default: "manual"
+    }),
+    /** Confounds logged for the day, e.g. ["alcohol","poor sleep"]. */
+    confounds: json({}),
+    /** Denormalized owning experiment (for fast per-experiment queries). */
+    experiment: relation({ target: "xnet://xnet.fyi/Experiment@1.0.0" }),
+    /** Canonical SECURITY home; empty = personal/private (exploration 0179). */
+    space: relation({ target: "xnet://xnet.fyi/Space@1.0.0" }),
+    /** Per-node visibility. Defaults to `private` (sensitive data, 0180). */
+    visibility: select({
+      options: [
+        { id: "inherit", name: "Inherit", color: "gray" },
+        { id: "private", name: "Private", color: "gray" },
+        { id: "unlisted", name: "Unlisted", color: "yellow" },
+        { id: "public", name: "Public", color: "green" }
+      ],
+      default: "private"
+    })
+  },
+  // Inherits access from its home Space (exploration 0181/0192).
+  authorization: spaceCascadeAuthorization()
+});
+
+export {
+  ObservationSchema
+};

package/dist/chunk-WEPK7SZF.js

@@ -0,0 +1,65 @@
+import {
+  spaceCascadeAuthorization
+} from "./chunk-OCMSAKWV.js";
+import {
+  defineSchema,
+  json,
+  number,
+  relation,
+  text
+} from "./chunk-EBNMV2VO.js";
+
+// src/schema/schemas/schema-extension.ts
+var SCHEMA_EXTENSION_SCHEMA_IRI = "xnet://xnet.fyi/SchemaExtension@1.0.0";
+var EXTENSION_FIELD_SCHEMA_IRI = "xnet://xnet.fyi/ExtensionField@1.0.0";
+var SchemaExtensionSchema = defineSchema({
+  name: "SchemaExtension",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Versioned IRI of the schema being extended, e.g. 'xnet://xnet.fyi/Contact@1.0.0' */
+    targetSchema: text({ required: true, maxLength: 300 }),
+    /**
+     * Namespace authority that owns these fields — a Space id, a DID, or a
+     * domain. Becomes the `<authority>` segment of every `ext:` key, so two
+     * tenants extending the same schema never collide.
+     */
+    authority: text({ required: true, maxLength: 200 }),
+    /** Human-readable label for the extension set (e.g. "Acme CRM fields") */
+    label: text({ maxLength: 200 }),
+    /** Optional owning Space — drives the authorization cascade for this overlay */
+    space: relation({ target: "xnet://xnet.fyi/Space@1.0.0" })
+  },
+  authorization: spaceCascadeAuthorization()
+});
+var ExtensionFieldSchema = defineSchema({
+  name: "ExtensionField",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Parent SchemaExtension */
+    extension: relation({ target: SCHEMA_EXTENSION_SCHEMA_IRI, required: true }),
+    /** Field token — the `<field>` segment of the `ext:<authority>/<field>` key */
+    name: text({ required: true, maxLength: 200 }),
+    /** Field type (FieldType union, enforced in field-operations) */
+    type: text({ required: true, maxLength: 50 }),
+    /** Type-specific configuration (FieldConfig) */
+    config: json({}),
+    /** Fractional index for ordering among a schema's extension fields */
+    sortKey: text({ required: true }),
+    /** Default column width in pixels (table views) */
+    width: number({ min: 40, integer: true }),
+    /** Optional owning Space — mirrors the parent extension's cascade */
+    space: relation({ target: "xnet://xnet.fyi/Space@1.0.0" })
+  },
+  authorization: spaceCascadeAuthorization()
+});
+function schemaExtensionId(authority, targetSchema) {
+  return `schemaext:${authority}:${targetSchema}`;
+}
+
+export {
+  SCHEMA_EXTENSION_SCHEMA_IRI,
+  EXTENSION_FIELD_SCHEMA_IRI,
+  SchemaExtensionSchema,
+  ExtensionFieldSchema,
+  schemaExtensionId
+};

package/dist/chunk-XHEA5UER.js

@@ -0,0 +1,75 @@
+// src/updates.ts
+import { sign, verify, hashHex } from "@xnetjs/crypto";
+import * as Y from "yjs";
+function signUpdate(options) {
+  const { update, authorDID, signingKey, parentHash, vectorClock } = options;
+  const updateHash = hashHex(update);
+  const timestamp = Date.now();
+  const signaturePayload = new TextEncoder().encode(
+    JSON.stringify({ updateHash, parentHash, authorDID, timestamp })
+  );
+  const signature = sign(signaturePayload, signingKey);
+  return {
+    update,
+    parentHash,
+    updateHash,
+    authorDID,
+    signature,
+    timestamp,
+    vectorClock
+  };
+}
+function verifyUpdate(update, getPublicKey) {
+  const publicKey = getPublicKey(update.authorDID);
+  if (!publicKey) return false;
+  const actualHash = hashHex(update.update);
+  if (actualHash !== update.updateHash) return false;
+  const signaturePayload = new TextEncoder().encode(
+    JSON.stringify({
+      updateHash: update.updateHash,
+      parentHash: update.parentHash,
+      authorDID: update.authorDID,
+      timestamp: update.timestamp
+    })
+  );
+  return verify(signaturePayload, update.signature, publicKey);
+}
+function applySignedUpdate(doc, update) {
+  Y.applyUpdate(doc, update.update);
+}
+function captureUpdate(doc, authorDID, signingKey, parentHash, vectorClock, callback) {
+  let capturedUpdate = null;
+  const handler = (update) => {
+    capturedUpdate = update;
+  };
+  doc.on("update", handler);
+  callback();
+  doc.off("update", handler);
+  if (!capturedUpdate) return null;
+  return signUpdate({
+    doc,
+    update: capturedUpdate,
+    authorDID,
+    signingKey,
+    parentHash,
+    vectorClock
+  });
+}
+function mergeDocuments(target, sources) {
+  for (const source of sources) {
+    const state = Y.encodeStateAsUpdate(source);
+    Y.applyUpdate(target, state);
+  }
+}
+function getMissingUpdates(doc, remoteStateVector) {
+  return Y.encodeStateAsUpdate(doc, remoteStateVector);
+}
+
+export {
+  signUpdate,
+  verifyUpdate,
+  applySignedUpdate,
+  captureUpdate,
+  mergeDocuments,
+  getMissingUpdates
+};

package/dist/chunk-XMSKJ5PV.js

@@ -0,0 +1,66 @@
+import {
+  spaceCascadeAuthorization
+} from "./chunk-OCMSAKWV.js";
+import {
+  checkbox,
+  defineSchema,
+  relation,
+  select,
+  text
+} from "./chunk-EBNMV2VO.js";
+
+// src/schema/schemas/account.ts
+var ACCOUNT_SCHEMA_IRI = "xnet://xnet.fyi/Account@1.0.0";
+var AccountSchema = defineSchema({
+  name: "Account",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Display name, e.g. "Checking" or "Groceries". */
+    name: text({ required: true, maxLength: 200 }),
+    /** The double-entry class — drives debit/credit sign and reporting bucket. */
+    class: select({
+      options: [
+        { id: "asset", name: "Asset", color: "green" },
+        { id: "liability", name: "Liability", color: "red" },
+        { id: "equity", name: "Equity", color: "purple" },
+        { id: "income", name: "Income", color: "blue" },
+        { id: "expense", name: "Expense", color: "orange" }
+      ],
+      default: "expense"
+    }),
+    /** Hierarchical code for ordering / roll-up, e.g. "1000", "1010". */
+    code: text({ maxLength: 40 }),
+    /** ISO-4217 reporting currency for this account (app default: USD). */
+    currency: text({ maxLength: 3 }),
+    /** Roll-up group header (no postings of its own) vs a postable leaf. */
+    isGroup: checkbox({ default: false }),
+    /** Chart-of-accounts tree parent. */
+    parent: relation({ target: ACCOUNT_SCHEMA_IRI }),
+    /** Order among siblings — fractional index (exploration 0169 pattern). */
+    sortKey: text({ maxLength: 500 }),
+    /** Optional folder home for uniform filing; empty = Unfiled (0190). */
+    folder: relation({ target: "xnet://xnet.fyi/Folder@1.0.0" }),
+    /** Canonical SECURITY home; empty = personal/private book (0179/0181). */
+    space: relation({ target: "xnet://xnet.fyi/Space@1.0.0" }),
+    /**
+     * Per-node visibility. Defaults to `private` — financial data is the most
+     * sensitive in the app and must never leak to public surfaces (0187).
+     */
+    visibility: select({
+      options: [
+        { id: "inherit", name: "Inherit", color: "gray" },
+        { id: "private", name: "Private", color: "gray" },
+        { id: "unlisted", name: "Unlisted", color: "yellow" },
+        { id: "public", name: "Public", color: "green" }
+      ],
+      default: "private"
+    })
+  },
+  // Inherits access from its home Space (exploration 0181).
+  authorization: spaceCascadeAuthorization()
+});
+
+export {
+  ACCOUNT_SCHEMA_IRI,
+  AccountSchema
+};

package/dist/chunk-XROI44ZP.js

@@ -0,0 +1,64 @@
+import {
+  spaceCascadeAuthorization
+} from "./chunk-OCMSAKWV.js";
+import {
+  date,
+  defineSchema,
+  person,
+  relation,
+  select,
+  text
+} from "./chunk-EBNMV2VO.js";
+
+// src/schema/schemas/project.ts
+var ProjectSchema = defineSchema({
+  name: "Project",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Project name */
+    name: text({ required: true, maxLength: 200 }),
+    /** Emoji or icon URL */
+    icon: text({ maxLength: 500 }),
+    /** Project lifecycle status */
+    status: select({
+      options: [
+        { id: "planned", name: "Planned", color: "gray" },
+        { id: "in-progress", name: "In Progress", color: "blue" },
+        { id: "paused", name: "Paused", color: "yellow" },
+        { id: "completed", name: "Completed", color: "green" },
+        { id: "cancelled", name: "Cancelled", color: "red" }
+      ],
+      default: "planned"
+    }),
+    /** Project lead */
+    lead: person({}),
+    /** Target completion date */
+    targetDate: date({}),
+    /** Canonical home; empty = Unfiled (exploration 0169) */
+    folder: relation({ target: "xnet://xnet.fyi/Folder@1.0.0" }),
+    /** Order among folder siblings — fractional index */
+    sortKey: text({ maxLength: 500 }),
+    /** Workspace-wide labels, referenced by id (exploration 0169) */
+    tags: relation({ target: "xnet://xnet.fyi/Tag@1.0.0", multiple: true }),
+    /** Canonical SECURITY home; empty = personal/private (exploration 0179) */
+    space: relation({ target: "xnet://xnet.fyi/Space@1.0.0" }),
+    /** Per-node visibility; `inherit` defers to the Space (exploration 0179) */
+    visibility: select({
+      options: [
+        { id: "inherit", name: "Inherit", color: "gray" },
+        { id: "private", name: "Private", color: "gray" },
+        { id: "unlisted", name: "Unlisted", color: "yellow" },
+        { id: "public", name: "Public", color: "green" }
+      ],
+      default: "inherit"
+    })
+  },
+  document: "yjs",
+  // Collaborative project brief
+  // Inherits access from its home Space (exploration 0181).
+  authorization: spaceCascadeAuthorization()
+});
+
+export {
+  ProjectSchema
+};

package/dist/chunk-Y3S5SRVM.js

@@ -0,0 +1,45 @@
+import {
+  spaceCascadeAuthorization
+} from "./chunk-OCMSAKWV.js";
+import {
+  created,
+  createdBy,
+  defineSchema,
+  person,
+  relation,
+  select,
+  text
+} from "./chunk-EBNMV2VO.js";
+
+// src/schema/schemas/reaction.ts
+var reactionTypes = [
+  { id: "like", name: "Like", color: "green" },
+  { id: "repost", name: "Repost", color: "blue" },
+  { id: "bookmark", name: "Bookmark", color: "purple" },
+  { id: "emoji", name: "Emoji", color: "yellow" }
+];
+var ReactionSchema = defineSchema({
+  name: "Reaction",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    target: relation({ required: true }),
+    targetSchema: text({}),
+    reactionType: select({
+      options: reactionTypes,
+      required: true,
+      default: "like"
+    }),
+    reactor: person({ required: true }),
+    emoji: text({ maxLength: 32 }),
+    annotation: text({ maxLength: 1e3 }),
+    createdAt: created(),
+    createdBy: createdBy()
+  },
+  document: void 0,
+  // Inherits access from its home Space (exploration 0181/0192).
+  authorization: spaceCascadeAuthorization("target")
+});
+
+export {
+  ReactionSchema
+};

package/dist/chunk-YEFKQYKA.js

@@ -0,0 +1,43 @@
+import {
+  created,
+  createdBy,
+  defineSchema,
+  json,
+  person
+} from "./chunk-EBNMV2VO.js";
+import {
+  presets
+} from "./chunk-RL64OJJ5.js";
+
+// src/schema/schemas/inbox-state.ts
+var DEFAULT_CHANNEL_TIER = "mentions";
+var InboxStateSchema = defineSchema({
+  name: "InboxState",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** The user this state belongs to (must match createdBy) */
+    owner: person({ required: true }),
+    /** channelId → last-read watermark */
+    watermarks: json({}),
+    /** Source node IDs of explicitly acknowledged mentions */
+    ackedMentions: json({}),
+    /** Source node ID → triage state (sparse; absence = unread/read derived) */
+    items: json({}),
+    /** Notification preferences */
+    prefs: json({}),
+    createdAt: created(),
+    createdBy: createdBy()
+  },
+  document: void 0,
+  // Standalone/personal content: owner-only by default (exploration 0192).
+  authorization: presets.private()
+});
+function inboxStateNodeId(did) {
+  return `inbox-${did}`;
+}
+
+export {
+  DEFAULT_CHANNEL_TIER,
+  InboxStateSchema,
+  inboxStateNodeId
+};