@xnetjs/data 0.0.2 → 0.0.3

package/dist/chunk-54Y7QRZN.js

@@ -0,0 +1,109 @@
+import {
+  spaceCascadeAuthorization
+} from "./chunk-6OPZJ7MG.js";
+import {
+  defineSchema,
+  json,
+  number,
+  relation,
+  select,
+  text
+} from "./chunk-O64EK5FK.js";
+
+// src/schema/schemas/metric.ts
+var MetricSchema = defineSchema({
+  name: "Metric",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Display name, e.g. "Meditate" or "Sleep latency". */
+    name: text({ required: true, maxLength: 200 }),
+    /** Emoji or icon URL. */
+    icon: text({ maxLength: 500 }),
+    /** Accent color for streak chips / charts. */
+    color: text({ maxLength: 40 }),
+    /**
+     * What kind of value an Observation carries — drives both logging UI and
+     * aggregation. `boolean` is the classic habit check-in (value 0/1);
+     * `scale` is a bounded rating (mood 1–5); the rest are free numerics.
+     */
+    kind: select({
+      options: [
+        { id: "boolean", name: "Yes / No" },
+        { id: "count", name: "Count" },
+        { id: "duration", name: "Duration" },
+        { id: "scale", name: "Scale" },
+        { id: "number", name: "Number" }
+      ],
+      default: "boolean"
+    }),
+    /** Unit label for numeric kinds, e.g. "min", "pages", "glasses". */
+    unit: text({ maxLength: 40 }),
+    /** Lower bound for `scale` kind (e.g. 1). */
+    scaleMin: number({}),
+    /** Upper bound for `scale` kind (e.g. 5). */
+    scaleMax: number({}),
+    /**
+     * A recurring schedule makes this Metric a habit. `none` = ad-hoc /
+     * continuous (no streak, no "miss").
+     */
+    schedule: select({
+      options: [
+        { id: "none", name: "No schedule" },
+        { id: "daily", name: "Daily" },
+        { id: "weekly", name: "Weekly" },
+        { id: "specificDays", name: "Specific days" }
+      ],
+      default: "none"
+    }),
+    /** Weekdays (0 = Sun … 6 = Sat) for `specificDays`, or anchor for `weekly`. */
+    scheduleDays: json({}),
+    /** Which direction counts as improvement, for the verdict engine. */
+    polarity: select({
+      options: [
+        { id: "higherBetter", name: "Higher is better" },
+        { id: "lowerBetter", name: "Lower is better" },
+        { id: "neutral", name: "Neutral" }
+      ],
+      default: "higherBetter"
+    }),
+    /** Optional target value (e.g. "50 pushups", "≥ 7 h sleep"). */
+    target: number({}),
+    /**
+     * Implementation intention — "after I pour my morning coffee, I will…".
+     * A written cue roughly doubles follow-through (Gollwitzer, 1999).
+     */
+    cue: text({ maxLength: 280 }),
+    /**
+     * Optional owning experiment. A Metric can be standalone (mood, sleep) and
+     * referenced by many experiments, so this is not required.
+     */
+    experiment: relation({ target: "xnet://xnet.fyi/Experiment@1.0.0" }),
+    /** Canonical home; empty = Unfiled (exploration 0169). */
+    folder: relation({ target: "xnet://xnet.fyi/Folder@1.0.0" }),
+    /** Order among 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. Defaults to `private` — mood/health/habit data is
+     * sensitive and must never leak to public surfaces by accident (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 {
+  MetricSchema
+};

package/dist/chunk-5FHJE7RC.js

@@ -0,0 +1,46 @@
+import {
+  defineSchema,
+  file,
+  number,
+  select,
+  text
+} from "./chunk-O64EK5FK.js";
+import {
+  presets
+} from "./chunk-JESSJ5CZ.js";
+
+// src/schema/schemas/media-asset.ts
+var MediaAssetSchema = defineSchema({
+  name: "MediaAsset",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Display title */
+    title: text({ required: true, maxLength: 500 }),
+    /** Primary file reference */
+    file: file({ required: true }),
+    /** Normalized media kind */
+    kind: select({
+      options: [
+        { id: "image", name: "Image" },
+        { id: "video", name: "Video" },
+        { id: "audio", name: "Audio" },
+        { id: "document", name: "Document" },
+        { id: "file", name: "File" }
+      ],
+      default: "file"
+    }),
+    /** Optional alt text or description */
+    alt: text({ maxLength: 2e3 }),
+    /** Natural width when known */
+    width: number({ integer: true, min: 0 }),
+    /** Natural height when known */
+    height: number({ integer: true, min: 0 })
+  },
+  document: void 0,
+  // Standalone/personal content: owner-only by default (exploration 0192).
+  authorization: presets.private()
+});
+
+export {
+  MediaAssetSchema
+};

package/dist/chunk-64AM6JPM.js

@@ -0,0 +1,40 @@
+import {
+  created,
+  createdBy,
+  defineSchema,
+  person,
+  text
+} from "./chunk-O64EK5FK.js";
+
+// src/schema/schemas/profile.ts
+var ProfileSchema = defineSchema({
+  name: "Profile",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** The DID this profile describes (should match createdBy) */
+    did: person({ required: true }),
+    /** Human-readable display name */
+    displayName: text({ required: true, maxLength: 120 }),
+    /**
+     * Optional @handle — a short, workspace-unique slug for typing mentions
+     * (exploration 0172). The stable identity is always the DID; the handle is
+     * a resolver input at compose time and a display option at read time, so a
+     * rename never breaks an existing mention. Global uniqueness is out of
+     * scope — the DID remains the source of truth.
+     */
+    handle: text({ maxLength: 32 }),
+    /** Avatar URL or blob reference */
+    avatar: text({ maxLength: 500 }),
+    /** Short status emoji (e.g. 🔴, 🌴) */
+    statusEmoji: text({ maxLength: 32 }),
+    /** Free-form status message */
+    statusMessage: text({ maxLength: 200 }),
+    createdAt: created(),
+    createdBy: createdBy()
+  },
+  document: void 0
+});
+
+export {
+  ProfileSchema
+};

package/dist/chunk-6CN53PON.js

@@ -0,0 +1,143 @@
+import {
+  buildFolderTree,
+  flattenFolderTree,
+  folderAncestorIds,
+  folderPathIds,
+  wouldCreateFolderCycle
+} from "./chunk-DTPSTMUD.js";
+import {
+  spaceOwnAuthorization
+} from "./chunk-6OPZJ7MG.js";
+import {
+  checkbox,
+  created,
+  createdBy,
+  defineSchema,
+  person,
+  relation,
+  select,
+  text
+} from "./chunk-O64EK5FK.js";
+
+// src/schema/schemas/space.ts
+var SPACE_SCHEMA_IRI = "xnet://xnet.fyi/Space@1.0.0";
+var SPACE_KINDS = [
+  "personal",
+  "workspace",
+  "organization",
+  "team",
+  "community",
+  "family"
+];
+var SPACE_VISIBILITY = ["private", "unlisted", "public"];
+var NODE_VISIBILITY = ["inherit", "private", "unlisted", "public"];
+var SpaceSchema = defineSchema({
+  name: "Space",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Space display name */
+    name: text({ required: true, maxLength: 200 }),
+    /** Flavor — selects presets only */
+    kind: select({
+      options: [
+        { id: "personal", name: "Personal", color: "gray" },
+        { id: "workspace", name: "Workspace", color: "blue" },
+        { id: "organization", name: "Organization", color: "purple" },
+        { id: "team", name: "Team", color: "green" },
+        { id: "community", name: "Community", color: "pink" },
+        { id: "family", name: "Family", color: "red" }
+      ],
+      required: true,
+      default: "workspace"
+    }),
+    /** Nesting parent; empty = top-level (exploration 0179) */
+    parent: relation({ target: "xnet://xnet.fyi/Space@1.0.0" }),
+    /** Private by default; unlisted via links; public is a deliberate escalation */
+    visibility: select({
+      options: [
+        { id: "private", name: "Private", color: "gray" },
+        { id: "unlisted", name: "Unlisted", color: "yellow" },
+        { id: "public", name: "Public", color: "green" }
+      ],
+      required: true,
+      default: "private"
+    }),
+    /** Governance set — the admin/owner DIDs (no group DID needed in v1) */
+    owners: person({ multiple: true }),
+    /** Short description / purpose */
+    description: text({ maxLength: 2e3 }),
+    /** Emoji or icon URL */
+    icon: text({ maxLength: 500 }),
+    /** Accent color */
+    color: text({ maxLength: 30 }),
+    /** Order among siblings — fractional index, code-unit compare */
+    sortKey: text({ maxLength: 500 }),
+    /** Archived spaces are hidden from the default list */
+    archived: checkbox({ default: false }),
+    createdAt: created(),
+    createdBy: createdBy()
+  },
+  document: void 0,
+  // Members resolve from SpaceMembership edges and cascade down the `parent`
+  // chain (exploration 0181). Content inherits these via `role.relation`.
+  authorization: spaceOwnAuthorization()
+});
+var SPACE_ROLES = ["viewer", "commenter", "member", "admin", "owner"];
+var SPACE_ROLE_RANK = {
+  viewer: 0,
+  commenter: 1,
+  member: 2,
+  admin: 3,
+  owner: 4
+};
+var compareSpaceRoles = (a, b) => SPACE_ROLE_RANK[a] - SPACE_ROLE_RANK[b];
+function effectiveSpaceRole(roles) {
+  let best = null;
+  for (const role of roles) {
+    if (!best || compareSpaceRoles(role, best) > 0) best = role;
+  }
+  return best;
+}
+var canManageSpace = (role) => role === "admin" || role === "owner";
+function spaceRoleGrantActions(role) {
+  switch (role) {
+    case "viewer":
+      return ["read"];
+    case "commenter":
+      return ["read", "comment"];
+    case "member":
+      return ["read", "comment", "write"];
+    case "admin":
+    case "owner":
+      return ["read", "comment", "write", "share", "admin"];
+  }
+}
+function spaceRoleToShareRole(role) {
+  if (role === "viewer") return "read";
+  if (role === "commenter") return "comment";
+  return "write";
+}
+var buildSpaceTree = buildFolderTree;
+var flattenSpaceTree = flattenFolderTree;
+var spaceAncestorIds = folderAncestorIds;
+var spacePathIds = folderPathIds;
+var wouldCreateSpaceCycle = wouldCreateFolderCycle;
+
+export {
+  SPACE_SCHEMA_IRI,
+  SPACE_KINDS,
+  SPACE_VISIBILITY,
+  NODE_VISIBILITY,
+  SpaceSchema,
+  SPACE_ROLES,
+  compareSpaceRoles,
+  effectiveSpaceRole,
+  canManageSpace,
+  spaceRoleGrantActions,
+  spaceRoleToShareRole,
+  buildSpaceTree,
+  flattenSpaceTree,
+  spaceAncestorIds,
+  spacePathIds,
+  wouldCreateSpaceCycle
+};

package/dist/chunk-6GB7PBCR.js

@@ -0,0 +1,40 @@
+import {
+  spaceCascadeAuthorization
+} from "./chunk-6OPZJ7MG.js";
+import {
+  defineSchema,
+  relation,
+  select,
+  text
+} from "./chunk-O64EK5FK.js";
+
+// src/schema/schemas/saved-view.ts
+var SavedViewSchema = defineSchema({
+  name: "SavedView",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Human-readable view title */
+    title: text({ required: true, maxLength: 500 }),
+    /** Optional user-facing description */
+    description: text({ maxLength: 4e3 }),
+    /** JSON-serialized SavedViewDescriptor from store/query-ast */
+    descriptor: text({ required: true }),
+    /** Visibility and ownership boundary for the saved descriptor */
+    scope: select({
+      options: [
+        { id: "user", name: "User" },
+        { id: "workspace", name: "Workspace" },
+        { id: "database", name: "Database" }
+      ],
+      default: "workspace"
+    }),
+    /** Optional database that owns database-scoped views */
+    database: relation({ target: "xnet://xnet.fyi/Database@2.0.0" })
+  },
+  // Inherits access from its home Space (exploration 0181/0192).
+  authorization: spaceCascadeAuthorization("database")
+});
+
+export {
+  SavedViewSchema
+};

package/dist/chunk-6OPZJ7MG.js

@@ -0,0 +1,78 @@
+import {
+  SPACE_MEMBERSHIP_SCHEMA_IRI
+} from "./chunk-ZICIXDEE.js";
+import {
+  allow,
+  role
+} from "./chunk-JESSJ5CZ.js";
+
+// src/schema/schemas/space-authorization.ts
+var ROLE_ORDER = ["viewer", "commenter", "member", "admin", "owner"];
+var membersAtLeast = (minRole) => role.members({
+  edgeSchema: SPACE_MEMBERSHIP_SCHEMA_IRI,
+  containerProp: "space",
+  memberProp: "member",
+  roleProp: "role",
+  minRole,
+  roleOrder: ROLE_ORDER,
+  parentProp: "parent"
+});
+function spaceOwnAuthorization() {
+  return {
+    roles: {
+      owner: role.creator(),
+      spaceManager: role.property("owners"),
+      spaceOwner: membersAtLeast("owner"),
+      spaceAdmin: membersAtLeast("admin"),
+      spaceMember: membersAtLeast("member"),
+      spaceCommenter: membersAtLeast("commenter"),
+      spaceViewer: membersAtLeast("viewer")
+    },
+    actions: {
+      // commenters/viewers fold into read; write needs member+; manage needs admin+
+      read: allow(
+        "owner",
+        "spaceManager",
+        "spaceOwner",
+        "spaceAdmin",
+        "spaceMember",
+        "spaceCommenter",
+        "spaceViewer"
+      ),
+      write: allow("owner", "spaceManager", "spaceOwner", "spaceAdmin", "spaceMember"),
+      delete: allow("owner", "spaceManager", "spaceOwner", "spaceAdmin"),
+      share: allow("owner", "spaceManager", "spaceOwner", "spaceAdmin"),
+      admin: allow("owner", "spaceManager", "spaceOwner", "spaceAdmin")
+    }
+  };
+}
+function spaceCascadeAuthorization(relationName = "space") {
+  return {
+    roles: {
+      owner: role.creator(),
+      spaceOwner: role.relation(relationName, "spaceOwner"),
+      spaceAdmin: role.relation(relationName, "spaceAdmin"),
+      spaceMember: role.relation(relationName, "spaceMember"),
+      spaceCommenter: role.relation(relationName, "spaceCommenter"),
+      spaceViewer: role.relation(relationName, "spaceViewer")
+    },
+    actions: {
+      read: allow(
+        "owner",
+        "spaceOwner",
+        "spaceAdmin",
+        "spaceMember",
+        "spaceCommenter",
+        "spaceViewer"
+      ),
+      write: allow("owner", "spaceOwner", "spaceAdmin", "spaceMember"),
+      delete: allow("owner", "spaceOwner", "spaceAdmin"),
+      share: allow("owner", "spaceOwner", "spaceAdmin")
+    }
+  };
+}
+
+export {
+  spaceOwnAuthorization,
+  spaceCascadeAuthorization
+};

package/dist/{chunk-IDMBCRUC.js → chunk-77UDLVQY.js}

@@ -3,7 +3,7 @@ import {
   number,
   person,
   text
-} from "./chunk-SZC345Z2.js";
+} from "./chunk-O64EK5FK.js";
 
 // src/schema/schemas/grant.ts
 var GrantSchema = defineSchema({

package/dist/chunk-7GMJOAPF.js

@@ -0,0 +1,52 @@
+import {
+  spaceCascadeAuthorization
+} from "./chunk-6OPZJ7MG.js";
+import {
+  defineSchema,
+  json,
+  relation,
+  select,
+  text
+} from "./chunk-O64EK5FK.js";
+
+// src/schema/schemas/map.ts
+var MapSchema = defineSchema({
+  name: "Map",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Map title */
+    title: text({ required: true, maxLength: 500 }),
+    /** Emoji or icon URL */
+    icon: text({}),
+    /** Basemap identifier (open/key-less). Defaults to protomaps-light. */
+    basemap: text({ maxLength: 64 }),
+    /** Camera position — whole-value LWW */
+    viewport: json({}),
+    /** Ordered layer stack (bottom→top) — whole-list LWW */
+    layers: json({}),
+    /** 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"
+    })
+  },
+  // Inherits access from its home Space (exploration 0181/0192).
+  authorization: spaceCascadeAuthorization()
+});
+
+export {
+  MapSchema
+};

package/dist/chunk-7PDRDSFH.js

@@ -0,0 +1,69 @@
+// src/sync/awareness.ts
+import { Awareness } from "y-protocols/awareness";
+function createAwareness(doc) {
+  return new Awareness(doc);
+}
+function setLocalPresence(awareness, presence) {
+  awareness.setLocalState(presence);
+}
+function clearLocalPresence(awareness) {
+  awareness.setLocalState(null);
+}
+function getRemotePresences(awareness) {
+  const states = awareness.getStates();
+  const result = /* @__PURE__ */ new Map();
+  states.forEach((state, clientId) => {
+    if (state && clientId !== awareness.clientID) {
+      result.set(clientId, state);
+    }
+  });
+  return result;
+}
+function getAllPresences(awareness) {
+  const states = awareness.getStates();
+  const result = /* @__PURE__ */ new Map();
+  states.forEach((state, clientId) => {
+    if (state) {
+      result.set(clientId, state);
+    }
+  });
+  return result;
+}
+function onPresenceChange(awareness, callback) {
+  awareness.on("change", callback);
+  return () => awareness.off("change", callback);
+}
+function getLocalClientId(awareness) {
+  return awareness.clientID;
+}
+function generateUserColor() {
+  const colors = [
+    "#F44336",
+    "#E91E63",
+    "#9C27B0",
+    "#673AB7",
+    "#3F51B5",
+    "#2196F3",
+    "#03A9F4",
+    "#00BCD4",
+    "#009688",
+    "#4CAF50",
+    "#8BC34A",
+    "#CDDC39",
+    "#FFC107",
+    "#FF9800",
+    "#FF5722"
+  ];
+  return colors[Math.floor(Math.random() * colors.length)];
+}
+
+export {
+  createAwareness,
+  setLocalPresence,
+  clearLocalPresence,
+  getRemotePresences,
+  getAllPresences,
+  onPresenceChange,
+  getLocalClientId,
+  generateUserColor
+};

package/dist/chunk-C5IRSEEZ.js

@@ -0,0 +1,69 @@
+import {
+  defineSchema,
+  select,
+  text,
+  url
+} from "./chunk-O64EK5FK.js";
+import {
+  presets
+} from "./chunk-JESSJ5CZ.js";
+
+// src/schema/schemas/external-reference.ts
+var ExternalReferenceSchema = defineSchema({
+  name: "ExternalReference",
+  namespace: "xnet://xnet.fyi/",
+  properties: {
+    /** Canonical external URL */
+    url: url({ required: true }),
+    /** Normalized provider identifier */
+    provider: select({
+      options: [
+        { id: "github", name: "GitHub" },
+        { id: "figma", name: "Figma" },
+        { id: "youtube", name: "YouTube" },
+        { id: "loom", name: "Loom" },
+        { id: "vimeo", name: "Vimeo" },
+        { id: "codesandbox", name: "CodeSandbox" },
+        { id: "spotify", name: "Spotify" },
+        { id: "twitter", name: "Twitter" },
+        { id: "instagram", name: "Instagram" },
+        { id: "tiktok", name: "TikTok" },
+        { id: "generic", name: "Generic Link" }
+      ],
+      default: "generic"
+    }),
+    /** Normalized reference kind */
+    kind: select({
+      options: [
+        { id: "issue", name: "Issue" },
+        { id: "pull-request", name: "Pull Request" },
+        { id: "design", name: "Design" },
+        { id: "video", name: "Video" },
+        { id: "sandbox", name: "Sandbox" },
+        { id: "social", name: "Social Post" },
+        { id: "audio", name: "Audio" },
+        { id: "link", name: "Link" }
+      ],
+      default: "link"
+    }),
+    /** Provider-specific stable identifier */
+    refId: text({}),
+    /** Compact display title */
+    title: text({ required: true, maxLength: 500 }),
+    /** Secondary display label */
+    subtitle: text({ maxLength: 500 }),
+    /** Small icon or provider marker */
+    icon: text({ maxLength: 32 }),
+    /** Optional richer preview/embed URL */
+    embedUrl: url({}),
+    /** Provider-specific metadata stored as JSON */
+    metadata: text({ maxLength: 1e4 })
+  },
+  document: void 0,
+  // Standalone/personal content: owner-only by default (exploration 0192).
+  authorization: presets.private()
+});
+
+export {
+  ExternalReferenceSchema
+};