@byearlybird/starling 0.12.0 → 0.13.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["result: Record<string, R>","result: Record<string, unknown>","current: any","result: Document","result: Tombstones","mergeCollections","mergedDocuments: Record<DocumentId, Document>","mergeCollections","$state: ClockAtom","collectionSnapshotAtoms: ReadableAtom<Collection>[]","collectionsSnapshot: Record<string, Collection>"],"sources":["../lib/store/schema.ts","../lib/core/hex.ts","../lib/core/clock.ts","../lib/core/flatten.ts","../lib/core/document.ts","../lib/core/tombstone.ts","../lib/core/collection.ts","../lib/store/collection.ts","../lib/store/clock.ts","../lib/store/store.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nexport function validate<T extends StandardSchemaV1>(\n  schema: T,\n  input: StandardSchemaV1.InferInput<T>,\n): StandardSchemaV1.InferOutput<T> {\n  const result = schema[\"~standard\"].validate(input);\n  if (result instanceof Promise) {\n    throw new TypeError(\"Schema validation must be synchronous\");\n  }\n\n  if (result.issues) {\n    throw new Error(JSON.stringify(result.issues, null, 2));\n  }\n\n  return result.value;\n}\n\n/**\n * Base type constraint for any standard schema object\n */\nexport type AnyObject = StandardSchemaV1<Record<string, any>>;\n\nexport type SchemaWithId<T extends AnyObject> =\n  StandardSchemaV1.InferOutput<T> extends {\n    id: any;\n  }\n    ? T\n    : never;\n\nexport type Output<T extends AnyObject> = StandardSchemaV1.InferOutput<T>;\n\nexport type Input<T extends AnyObject> = StandardSchemaV1.InferInput<T>;\n","export function toHex(value: number, padLength: number): string {\n  return value.toString(16).padStart(padLength, \"0\");\n}\n\nexport function nonce(length: number): string {\n  const bytes = new Uint8Array(length / 2);\n  crypto.getRandomValues(bytes);\n  return Array.from(bytes)\n    .map((b) => toHex(b, 2))\n    .join(\"\");\n}\n","import { nonce, toHex } from \"./hex\";\n\nconst MS_LENGTH = 12;\nconst SEQ_LENGTH = 6;\nconst NONCE_LENGTH = 6;\n\nexport type Clock = {\n  ms: number;\n  seq: number;\n};\n\nexport function advanceClock(current: Clock, next: Clock): Clock {\n  if (next.ms > current.ms) {\n    return { ms: next.ms, seq: next.seq };\n  } else if (next.ms === current.ms) {\n    return { ms: current.ms, seq: Math.max(current.seq, next.seq) + 1 };\n  } else {\n    return { ms: current.ms, seq: current.seq + 1 };\n  }\n}\n\nexport function makeStamp(ms: number, seq: number): string {\n  return `${toHex(ms, MS_LENGTH)}${toHex(seq, SEQ_LENGTH)}${nonce(NONCE_LENGTH)}`;\n}\n\nexport function parseStamp(stamp: string): { ms: number; seq: number } {\n  return {\n    ms: parseInt(stamp.slice(0, MS_LENGTH), 16),\n    seq: parseInt(stamp.slice(MS_LENGTH, MS_LENGTH + SEQ_LENGTH), 16),\n  };\n}\n","/**\n * Flattens a nested object into a flat object with dot-notation keys\n * @param obj - The object to flatten\n * @param mapper - Optional callback to transform leaf values\n * @returns A flattened object with dot-notation keys\n */\nexport function flatten<T, R = unknown>(\n  obj: T,\n  mapper?: (value: unknown, path: string) => R,\n): Record<string, R> {\n  const result: Record<string, R> = {};\n\n  const addLeaf = (value: unknown, path: string) => {\n    if (path) {\n      result[path] = mapper ? mapper(value, path) : (value as R);\n    }\n  };\n\n  function traverse(current: unknown, prefix: string = \"\"): void {\n    if (!shouldTraverse(current)) {\n      addLeaf(current, prefix);\n      return;\n    }\n\n    for (const [key, value] of Object.entries(current)) {\n      const newPath = prefix ? `${prefix}.${key}` : key;\n      traverse(value, newPath);\n    }\n  }\n\n  traverse(obj);\n  return result;\n}\n\n/**\n * Unflattens a flat object with dot-notation keys into a nested object\n * @param obj - The flattened object to unflatten\n * @param mapper - Optional callback to transform leaf values before placing them\n * @returns A nested object\n */\nexport function unflatten<T = unknown, R = unknown>(\n  obj: Record<string, T>,\n  mapper?: (value: T, path: string) => R,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(obj)) {\n    const keys = path.split(\".\");\n    const mappedValue = mapper ? mapper(value, path) : value;\n\n    let current: any = result;\n    for (let i = 0; i < keys.length - 1; i++) {\n      const key = keys[i]!;\n      if (!(key in current)) {\n        current[key] = {};\n      }\n      current = current[key];\n    }\n\n    const finalKey = keys[keys.length - 1]!;\n    current[finalKey] = mappedValue;\n  }\n\n  return result;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    !Array.isArray(value) &&\n    (value.constructor === Object || Object.getPrototypeOf(value) === null)\n  );\n}\n\nfunction shouldTraverse(value: unknown): value is Record<string, unknown> {\n  return isPlainObject(value) && Object.keys(value).length > 0;\n}\n","import { flatten, unflatten } from \"./flatten\";\n\ntype Field<T = unknown> = {\n  \"~value\": T;\n  \"~stamp\": string;\n};\n\nexport type Document = Record<string, Field>;\n\nexport function makeDocument(\n  fields: Record<string, any>,\n  stamp: string,\n): Document {\n  return flatten(fields, (value) => ({ \"~value\": value, \"~stamp\": stamp }));\n}\n\nexport function parseDocument(document: Document): Record<string, any> {\n  return unflatten(document, (field) => field[\"~value\"]);\n}\n\nexport function mergeDocuments(target: Document, source: Document): Document {\n  const result: Document = {};\n  const keys = new Set([...Object.keys(target), ...Object.keys(source)]);\n\n  for (const key of keys) {\n    const targetValue = target[key];\n    const sourceValue = source[key];\n\n    if (targetValue && sourceValue) {\n      result[key] =\n        targetValue[\"~stamp\"] > sourceValue[\"~stamp\"]\n          ? targetValue\n          : sourceValue;\n    } else if (targetValue) {\n      result[key] = targetValue;\n    } else if (sourceValue) {\n      result[key] = sourceValue;\n    } else {\n      throw new Error(`Key ${key} not found in either document`);\n    }\n  }\n\n  return result;\n}\n","export type Tombstones = Record<string, string>;\n\nexport function mergeTombstones(\n  target: Tombstones,\n  source: Tombstones,\n): Tombstones {\n  const result: Tombstones = {};\n  const keys = new Set([...Object.keys(target), ...Object.keys(source)]);\n\n  for (const key of keys) {\n    const targetStamp = target[key];\n    const sourceStamp = source[key];\n\n    if (targetStamp && sourceStamp) {\n      result[key] = targetStamp > sourceStamp ? targetStamp : sourceStamp;\n    } else if (targetStamp) {\n      result[key] = targetStamp;\n    } else if (sourceStamp) {\n      result[key] = sourceStamp;\n    }\n  }\n\n  return result;\n}\n","import type { Document } from \"./document\";\nimport type { Tombstones } from \"./tombstone\";\nimport { mergeDocuments } from \"./document\";\nimport { mergeTombstones } from \"./tombstone\";\n\nexport type DocumentId = string;\n\nexport type Collection = {\n  documents: Record<DocumentId, Document>;\n  tombstones: Tombstones;\n};\n\nexport function mergeCollections(\n  target: Collection,\n  source: Collection,\n): Collection {\n  const mergedTombstones = mergeTombstones(\n    target.tombstones,\n    source.tombstones,\n  );\n\n  const mergedDocuments: Record<DocumentId, Document> = {};\n  const allDocumentIds = new Set([\n    ...Object.keys(target.documents),\n    ...Object.keys(source.documents),\n  ]);\n\n  for (const id of allDocumentIds) {\n    const targetDoc = target.documents[id];\n    const sourceDoc = source.documents[id];\n\n    if (mergedTombstones[id]) {\n      continue;\n    }\n\n    if (targetDoc && sourceDoc) {\n      mergedDocuments[id] = mergeDocuments(targetDoc, sourceDoc);\n    } else if (targetDoc) {\n      mergedDocuments[id] = targetDoc;\n    } else if (sourceDoc) {\n      mergedDocuments[id] = sourceDoc;\n    }\n  }\n\n  return {\n    documents: mergedDocuments,\n    tombstones: mergedTombstones,\n  };\n}\nexport function mergeCollectionRecords(\n  target: Record<string, Collection>,\n  source: Record<string, Collection>,\n): Record<string, Collection> {\n  const result: Record<string, Collection> = { ...target };\n\n  for (const [collectionName, sourceCollection] of Object.entries(source)) {\n    const targetCollection = result[collectionName];\n    if (targetCollection) {\n      result[collectionName] = mergeCollections(\n        targetCollection,\n        sourceCollection,\n      );\n    } else {\n      result[collectionName] = sourceCollection;\n    }\n  }\n\n  return result;\n}\n","import { batched, map, type ReadableAtom } from \"nanostores\";\nimport { validate } from \"./schema\";\nimport {\n  makeDocument,\n  parseDocument,\n  mergeDocuments,\n  mergeCollections,\n  type Collection,\n  type DocumentId,\n} from \"../core\";\nimport type { AnyObject, SchemaWithId, Output, Input } from \"./schema\";\nimport type { ClockAPI } from \"./clock\";\n\nexport type CollectionConfig<T extends AnyObject> =\n  | {\n      schema: T;\n      getId: (data: Output<T>) => DocumentId;\n    }\n  | {\n      schema: SchemaWithId<T>;\n    };\n\nexport type CollectionApi<T extends AnyObject> = {\n  $data: ReadableAtom<ReadonlyMap<DocumentId, Output<T>>>;\n  $snapshot: ReadableAtom<Collection>;\n  add(data: Input<T>): void;\n  remove(id: DocumentId): void;\n  update(id: DocumentId, document: Partial<Input<T>>): void;\n  merge(snapshot: Collection): void;\n} & Pick<\n  ReadonlyMap<DocumentId, Output<T>>,\n  \"get\" | \"has\" | \"keys\" | \"values\" | \"entries\" | \"forEach\" | \"size\"\n>;\n\ntype TickFunction = () => string;\n\nexport function addDocument<T extends AnyObject>(\n  $documents: ReturnType<typeof map<Collection[\"documents\"]>>,\n  config: CollectionConfig<T>,\n  tick: TickFunction,\n  data: Input<T>,\n): void {\n  const getId = defineGetId(config);\n  const valid = validate(config.schema, data);\n  const doc = makeDocument(valid, tick());\n  const id = getId(valid);\n  $documents.setKey(id, doc);\n}\n\nexport function removeDocument(\n  $documents: ReturnType<typeof map<Collection[\"documents\"]>>,\n  $tombstones: ReturnType<typeof map<Collection[\"tombstones\"]>>,\n  tick: TickFunction,\n  id: DocumentId,\n): void {\n  $tombstones.setKey(id, tick());\n  $documents.setKey(id, undefined);\n}\n\nexport function updateDocument<T extends AnyObject>(\n  $documents: ReturnType<typeof map<Collection[\"documents\"]>>,\n  config: CollectionConfig<T>,\n  tick: TickFunction,\n  id: DocumentId,\n  document: Partial<Input<T>>,\n): void {\n  const current = $documents.get()[id];\n  if (!current) return;\n\n  const newAttrs = makeDocument(document, tick());\n  const doc = mergeDocuments(current, newAttrs);\n\n  validate(config.schema, parseDocument(doc));\n\n  $documents.setKey(id, doc);\n}\n\nexport function mergeCollectionSnapshot(\n  $documents: ReturnType<typeof map<Collection[\"documents\"]>>,\n  $tombstones: ReturnType<typeof map<Collection[\"tombstones\"]>>,\n  currentSnapshot: Collection,\n  incomingSnapshot: Collection,\n): void {\n  const merged = mergeCollections(currentSnapshot, incomingSnapshot);\n  $documents.set(merged.documents);\n  $tombstones.set(merged.tombstones);\n}\n\nexport function createCollection<T extends AnyObject>(\n  config: CollectionConfig<T>,\n  clock: ClockAPI,\n): CollectionApi<T> {\n  const { $data, $snapshot, $documents, $tombstones } =\n    createCollectionState<T>();\n\n  return {\n    $data,\n    $snapshot,\n    get(key: DocumentId) {\n      return $data.get().get(key);\n    },\n    has(key: DocumentId) {\n      return $data.get().has(key);\n    },\n    keys() {\n      return $data.get().keys();\n    },\n    values() {\n      return $data.get().values();\n    },\n    entries() {\n      return $data.get().entries();\n    },\n    forEach(\n      callbackfn: (\n        value: Output<T>,\n        key: DocumentId,\n        map: ReadonlyMap<DocumentId, Output<T>>,\n      ) => void,\n      thisArg?: any,\n    ) {\n      return $data.get().forEach(callbackfn, thisArg);\n    },\n    get size() {\n      return $data.get().size;\n    },\n    add(data: Input<T>) {\n      addDocument($documents, config, clock.tick, data);\n    },\n    remove(id: DocumentId) {\n      removeDocument($documents, $tombstones, clock.tick, id);\n    },\n    update(id: DocumentId, document: Partial<Input<T>>) {\n      updateDocument($documents, config, clock.tick, id, document);\n    },\n    merge(snapshot: Collection) {\n      const currentSnapshot = $snapshot.get();\n      mergeCollectionSnapshot(\n        $documents,\n        $tombstones,\n        currentSnapshot,\n        snapshot,\n      );\n    },\n  };\n}\n\nfunction createCollectionState<T extends AnyObject>(): {\n  $data: ReadableAtom<ReadonlyMap<DocumentId, Output<T>>>;\n  $snapshot: ReadableAtom<Collection>;\n  $documents: ReturnType<typeof map<Collection[\"documents\"]>>;\n  $tombstones: ReturnType<typeof map<Collection[\"tombstones\"]>>;\n} {\n  const $documents = map<Collection[\"documents\"]>({});\n  const $tombstones = map<Collection[\"tombstones\"]>({});\n  const $snapshot = batched([$documents, $tombstones], parseSnapshot);\n  const $data = batched([$documents, $tombstones], parseCollection<T>);\n\n  return {\n    $data,\n    $snapshot,\n    $documents,\n    $tombstones,\n  };\n}\n\nfunction hasIdProperty<T extends AnyObject>(\n  data: Output<T>,\n): data is { id: DocumentId } {\n  return (\n    typeof data === \"object\" &&\n    data !== null &&\n    \"id\" in data &&\n    typeof (data as any).id === \"string\"\n  );\n}\n\nfunction parseCollection<T extends AnyObject>(\n  documents: Collection[\"documents\"],\n  tombstones: Collection[\"tombstones\"],\n): ReadonlyMap<DocumentId, Output<T>> {\n  const result = new Map<DocumentId, Output<T>>();\n  for (const [id, doc] of Object.entries(documents)) {\n    if (!tombstones[id] && doc) {\n      result.set(id, parseDocument(doc));\n    }\n  }\n  return result;\n}\n\nfunction parseSnapshot(\n  documents: Collection[\"documents\"],\n  tombstones: Collection[\"tombstones\"],\n): Collection {\n  return {\n    documents,\n    tombstones,\n  };\n}\n\nfunction hasGetId<T extends AnyObject>(\n  config: CollectionConfig<T>,\n): config is {\n  schema: T;\n  getId: (data: Output<T>) => DocumentId;\n} {\n  return \"getId\" in config && typeof config.getId === \"function\";\n}\n\nfunction defineGetId<T extends AnyObject>(\n  config: CollectionConfig<T>,\n): (data: Output<T>) => DocumentId {\n  return hasGetId(config) ? config.getId : defaultGetId;\n}\n\nfunction defaultGetId<T extends AnyObject>(data: Output<T>): DocumentId {\n  if (hasIdProperty(data)) {\n    return data.id;\n  }\n  throw new Error(\n    \"Schema must have an 'id' property when getId is not provided\",\n  );\n}\n","import { atom } from \"nanostores\";\nimport type { Clock } from \"../core/clock\";\nimport { advanceClock, makeStamp } from \"../core/clock\";\n\ntype ClockAtom = ReturnType<typeof atom<Clock>>;\n\nexport type ClockAPI = {\n  $state: ClockAtom;\n  tick: () => string;\n  advance: (ms: number, seq: number) => void;\n};\n\nexport function createClock(): ClockAPI {\n  const $state: ClockAtom = atom<Clock>(nowClock());\n\n  const tick = () => {\n    const next = advanceClock($state.get(), nowClock());\n    $state.set(next);\n    return makeStamp(next.ms, next.seq);\n  };\n\n  const advance = (ms: number, seq: number) => {\n    const next = advanceClock($state.get(), { ms, seq });\n    $state.set(next);\n  };\n\n  return {\n    $state,\n    tick,\n    advance,\n  };\n}\n\nfunction nowClock(): Clock {\n  return { ms: Date.now(), seq: 0 };\n}\n","import { batched, computed, type ReadableAtom } from \"nanostores\";\nimport { createCollection } from \"./collection\";\nimport { createClock, type ClockAPI } from \"./clock\";\nimport type { CollectionConfig, CollectionApi } from \"./collection\";\nimport type { Clock } from \"../core/clock\";\nimport type { Collection } from \"../core/collection\";\n\nexport type StoreSnapshot = {\n  clock: Clock;\n  collections: Record<string, Collection>;\n};\n\nexport type StoreCollections<T extends Record<string, CollectionConfig<any>>> =\n  {\n    [K in keyof T]: T[K] extends CollectionConfig<infer S>\n      ? CollectionApi<S>\n      : never;\n  };\n\nexport type QueryCollections<\n  TCollections extends StoreCollections<any>,\n  TKeys extends readonly (keyof TCollections)[],\n> = {\n  [K in TKeys[number]]: TCollections[K] extends { $data: ReadableAtom<infer D> }\n    ? D\n    : never;\n};\n\nexport type StoreAPI<T extends Record<string, CollectionConfig<any>>> =\n  StoreCollections<T> & {\n    $snapshot: ReadableAtom<StoreSnapshot>;\n    query<TKeys extends readonly (keyof StoreCollections<T>)[], TResult>(\n      collections: TKeys,\n      callback: (\n        collections: QueryCollections<StoreCollections<T>, TKeys>,\n      ) => TResult,\n    ): ReadableAtom<TResult>;\n    merge(snapshot: StoreSnapshot): void;\n  };\n\nexport function createStore<\n  T extends Record<string, CollectionConfig<any>>,\n>(config: { collections: T }): StoreAPI<T> {\n  const clock = createClock();\n  const collections = initCollections(config.collections, clock);\n  const $snapshot = parseCollections(collections, clock.$state);\n\n  function getCollectionDataStores(\n    collectionNames: readonly (keyof StoreCollections<T>)[],\n  ): ReadableAtom<any>[] {\n    return collectionNames.map((name) => collections[name]!.$data);\n  }\n\n  return {\n    ...collections,\n    $snapshot,\n    query: <TKeys extends readonly (keyof StoreCollections<T>)[], TResult>(\n      collectionNames: TKeys,\n      callback: (\n        collections: QueryCollections<StoreCollections<T>, TKeys>,\n      ) => TResult,\n    ) => {\n      const atoms = getCollectionDataStores(collectionNames);\n\n      return computed(atoms, (...values) => {\n        const entries = collectionNames.map((name, i) => [name, values[i]]);\n        return callback(\n          Object.fromEntries(entries) as QueryCollections<\n            StoreCollections<T>,\n            TKeys\n          >,\n        );\n      });\n    },\n    merge: (snapshot) => {\n      clock.advance(snapshot.clock.ms, snapshot.clock.seq);\n      mergeCollections(collections, snapshot.collections);\n    },\n  };\n}\n\nfunction initCollections<T extends Record<string, CollectionConfig<any>>>(\n  collectionsConfig: T,\n  clock: ClockAPI,\n): StoreCollections<T> {\n  return Object.fromEntries(\n    Object.entries(collectionsConfig).map(([name, config]) => [\n      name,\n      createCollection(config, clock),\n    ]),\n  ) as StoreCollections<T>;\n}\n\nfunction parseCollections<T extends Record<string, CollectionConfig<any>>>(\n  collections: StoreCollections<T>,\n  clockState: ReadableAtom<Clock>,\n): ReadableAtom<StoreSnapshot> {\n  const collectionNames = Object.keys(collections);\n  const collectionSnapshotAtoms: ReadableAtom<Collection>[] = [];\n\n  for (const name of collectionNames) {\n    const collection = collections[name];\n    if (collection) {\n      collectionSnapshotAtoms.push(collection.$snapshot);\n    }\n  }\n\n  return batched(\n    [clockState, ...collectionSnapshotAtoms],\n    (clock, ...snapshots) => {\n      const collectionsSnapshot: Record<string, Collection> = {};\n      for (let i = 0; i < collectionNames.length; i++) {\n        const name = collectionNames[i];\n        const snapshot = snapshots[i];\n        if (name && snapshot !== undefined) {\n          collectionsSnapshot[name] = snapshot;\n        }\n      }\n\n      return {\n        clock,\n        collections: collectionsSnapshot,\n      };\n    },\n  );\n}\n\nfunction mergeCollections(\n  target: Record<string, CollectionApi<any>>,\n  source: Record<string, Collection>,\n) {\n  for (const [collectionName, collectionSnapshot] of Object.entries(source)) {\n    const collection = target[collectionName];\n    if (collection) {\n      collection.merge(collectionSnapshot);\n    }\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,46 +1,38 @@
 {
-	"name": "@byearlybird/starling",
-	"version": "0.12.0",
-	"description": "Local-first data sync for JavaScript apps. Typed collections, transactions, and automatic conflict resolution.",
-	"type": "module",
-	"license": "MIT",
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js",
-			"default": "./dist/index.js"
-		},
-		"./core": {
-			"types": "./dist/core.d.ts",
-			"import": "./dist/core.js",
-			"default": "./dist/core.js"
-		},
-		"./plugin-idb": {
-			"types": "./dist/plugin-idb.d.ts",
-			"import": "./dist/plugin-idb.js",
-			"default": "./dist/plugin-idb.js"
-		},
-		"./plugin-http": {
-			"types": "./dist/plugin-http.d.ts",
-			"import": "./dist/plugin-http.js",
-			"default": "./dist/plugin-http.js"
-		}
-	},
-	"files": [
-		"dist"
-	],
-	"scripts": {
-		"build": "bun run build.ts",
-		"prepublishOnly": "bun run build.ts"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"devDependencies": {
-		"fake-indexeddb": "^6.0.0",
-		"happy-dom": "^20.0.10",
-		"zod": "^4.1.12"
-	}
+  "name": "@byearlybird/starling",
+  "version": "0.13.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "format": "prettier . --write",
+    "format:check": "prettier . --check",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "prettier": "3.7.4",
+    "tsdown": "^0.18.3",
+    "zod": "^4.2.1"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@standard-schema/spec": "^1.1.0",
+    "nanostores": "^1.1.0"
+  }
 }

package/dist/core-UUzgRHaU.js

@@ -1,420 +0,0 @@
-//#region src/core/clock/errors.ts
-var InvalidEventstampError = class extends Error {
-	constructor(eventstamp) {
-		super(`Invalid eventstamp: "${eventstamp}"`);
-		this.name = "InvalidEventstampError";
-	}
-};
-
-//#endregion
-//#region src/core/clock/eventstamp.ts
-function generateNonce() {
-	return Math.random().toString(16).slice(2, 6).padStart(4, "0");
-}
-function encodeEventstamp(timestampMs, counter, nonce) {
-	return `${new Date(timestampMs).toISOString()}|${counter.toString(16).padStart(4, "0")}|${nonce}`;
-}
-const EVENTSTAMP_REGEX = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z\|[0-9a-f]{4,}\|[0-9a-f]{4}$/;
-/**
-* Validates whether a string is a properly formatted eventstamp.
-* Expected format: YYYY-MM-DDTHH:mm:ss.SSSZ|HHHH+|HHHH
-* where HHHH+ represents 4 or more hex characters for the counter,
-* and HHHH represents exactly 4 hex characters for the nonce.
-*/
-function isValidEventstamp(stamp) {
-	return EVENTSTAMP_REGEX.test(stamp);
-}
-function decodeEventstamp(eventstamp) {
-	if (!isValidEventstamp(eventstamp)) throw new InvalidEventstampError(eventstamp);
-	const parts = eventstamp.split("|");
-	const isoString = parts[0];
-	const hexCounter = parts[1];
-	const nonce = parts[2];
-	return {
-		timestampMs: new Date(isoString).getTime(),
-		counter: parseInt(hexCounter, 16),
-		nonce
-	};
-}
-const MIN_EVENTSTAMP = encodeEventstamp(0, 0, "0000");
-/**
-* Find the maximum eventstamp from an array of eventstamps.
-* Returns MIN_EVENTSTAMP if the array is empty.
-* @param eventstamps - Array of eventstamp strings
-* @returns The maximum eventstamp
-*/
-function maxEventstamp(eventstamps) {
-	if (eventstamps.length === 0) return MIN_EVENTSTAMP;
-	return eventstamps.reduce((max, stamp) => stamp > max ? stamp : max);
-}
-
-//#endregion
-//#region src/core/clock/clock.ts
-/**
-* Create a new Clock instance.
-* @param initialState - Optional initial state for the clock
-*/
-function createClock(initialState) {
-	let counter = initialState?.counter ?? 0;
-	let lastMs = initialState?.lastMs ?? Date.now();
-	let lastNonce = initialState?.lastNonce ?? generateNonce();
-	const now = () => {
-		const wallMs = Date.now();
-		if (wallMs > lastMs) {
-			lastMs = wallMs;
-			counter = 0;
-			lastNonce = generateNonce();
-		} else {
-			counter++;
-			lastNonce = generateNonce();
-		}
-		return encodeEventstamp(lastMs, counter, lastNonce);
-	};
-	const latest = () => encodeEventstamp(lastMs, counter, lastNonce);
-	const forward = (eventstamp) => {
-		if (!isValidEventstamp(eventstamp)) throw new InvalidEventstampError(eventstamp);
-		if (eventstamp > latest()) {
-			const newer = decodeEventstamp(eventstamp);
-			lastMs = newer.timestampMs;
-			counter = newer.counter;
-			lastNonce = newer.nonce;
-		}
-	};
-	return {
-		now,
-		latest,
-		forward
-	};
-}
-/**
-* Create a Clock from an eventstamp string.
-* @param eventstamp - Eventstamp string to decode and initialize clock from
-* @throws Error if eventstamp is invalid
-*/
-function createClockFromEventstamp(eventstamp) {
-	if (!isValidEventstamp(eventstamp)) throw new Error(`Invalid eventstamp: "${eventstamp}"`);
-	const decoded = decodeEventstamp(eventstamp);
-	return createClock({
-		counter: decoded.counter,
-		lastMs: decoded.timestampMs,
-		lastNonce: decoded.nonce
-	});
-}
-
-//#endregion
-//#region src/core/document/resource.ts
-function isObject(value) {
-	return value != null && typeof value === "object" && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
-}
-/**
-* Get a value from a nested object using a dot-separated path.
-* @internal
-*/
-function getValueAtPath(obj, path) {
-	const parts = path.split(".");
-	let current = obj;
-	for (const part of parts) {
-		if (current == null) return void 0;
-		current = current[part];
-	}
-	return current;
-}
-/**
-* Set a value in a nested object using a dot-separated path.
-* Creates intermediate objects as needed.
-* @internal
-*/
-function setValueAtPath(obj, path, value) {
-	const parts = path.split(".");
-	let current = obj;
-	for (let i = 0; i < parts.length - 1; i++) {
-		if (!current[parts[i]] || typeof current[parts[i]] !== "object") current[parts[i]] = {};
-		current = current[parts[i]];
-	}
-	current[parts[parts.length - 1]] = value;
-}
-/**
-* Compute the latest eventstamp for a resource from its field eventstamps and deletedAt.
-* Used internally and exported for testing/validation.
-* @internal
-*/
-function computeResourceLatest(eventstamps, deletedAt, fallback) {
-	let max = fallback ?? MIN_EVENTSTAMP;
-	for (const stamp of Object.values(eventstamps)) if (stamp > max) max = stamp;
-	if (deletedAt && deletedAt > max) return deletedAt;
-	return max;
-}
-function makeResource(id, obj, eventstamp, deletedAt = null) {
-	const eventstamps = {};
-	const traverse = (input, path = "") => {
-		for (const key in input) {
-			if (!Object.hasOwn(input, key)) continue;
-			const value = input[key];
-			const fieldPath = path ? `${path}.${key}` : key;
-			if (isObject(value)) traverse(value, fieldPath);
-			else eventstamps[fieldPath] = eventstamp;
-		}
-	};
-	traverse(obj);
-	return {
-		id,
-		attributes: obj,
-		meta: {
-			eventstamps,
-			latest: computeResourceLatest(eventstamps, deletedAt, eventstamp),
-			deletedAt
-		}
-	};
-}
-function mergeResources(into, from) {
-	const resultAttributes = {};
-	const resultEventstamps = {};
-	const allPaths = new Set([...Object.keys(into.meta.eventstamps), ...Object.keys(from.meta.eventstamps)]);
-	for (const path of allPaths) {
-		const stamp1 = into.meta.eventstamps[path];
-		const stamp2 = from.meta.eventstamps[path];
-		if (stamp1 && stamp2) if (stamp1 > stamp2) {
-			setValueAtPath(resultAttributes, path, getValueAtPath(into.attributes, path));
-			resultEventstamps[path] = stamp1;
-		} else {
-			setValueAtPath(resultAttributes, path, getValueAtPath(from.attributes, path));
-			resultEventstamps[path] = stamp2;
-		}
-		else if (stamp1) {
-			setValueAtPath(resultAttributes, path, getValueAtPath(into.attributes, path));
-			resultEventstamps[path] = stamp1;
-		} else {
-			setValueAtPath(resultAttributes, path, getValueAtPath(from.attributes, path));
-			resultEventstamps[path] = stamp2;
-		}
-	}
-	const dataLatest = computeResourceLatest(resultEventstamps, null, into.meta.latest > from.meta.latest ? into.meta.latest : from.meta.latest);
-	const mergedDeletedAt = into.meta.deletedAt && from.meta.deletedAt ? into.meta.deletedAt > from.meta.deletedAt ? into.meta.deletedAt : from.meta.deletedAt : into.meta.deletedAt || from.meta.deletedAt || null;
-	const finalLatest = mergedDeletedAt && mergedDeletedAt > dataLatest ? mergedDeletedAt : dataLatest;
-	return {
-		id: into.id,
-		attributes: resultAttributes,
-		meta: {
-			eventstamps: resultEventstamps,
-			latest: finalLatest,
-			deletedAt: mergedDeletedAt
-		}
-	};
-}
-function deleteResource(resource, eventstamp) {
-	const dataLatest = resource.meta.deletedAt ? computeResourceLatest(resource.meta.eventstamps, null) : resource.meta.latest;
-	const latest = eventstamp > dataLatest ? eventstamp : dataLatest;
-	return {
-		id: resource.id,
-		attributes: resource.attributes,
-		meta: {
-			eventstamps: resource.meta.eventstamps,
-			latest,
-			deletedAt: eventstamp
-		}
-	};
-}
-
-//#endregion
-//#region src/core/document/document.ts
-/**
-* Merges two Starling documents using field-level Last-Write-Wins semantics.
-*
-* The merge operation:
-* 1. Forwards the clock to the newest eventstamp from either document
-* 2. Merges each resource pair using field-level LWW (via mergeResources)
-* 3. Tracks what changed for hook notifications (added/updated/deleted)
-*
-* Deletion is final: once a resource is deleted, updates to it are merged into
-* the resource's attributes but don't restore visibility. Only new resources or
-* transitions into the deleted state are tracked.
-*
-* @param into - The base document to merge into
-* @param from - The source document to merge from
-* @returns Merged document and categorized changes
-*
-* @example
-* ```typescript
-* const into = {
-*   type: "items",
-*   latest: "2025-01-01T00:00:00.000Z|0001|a1b2",
-*   resources: { "doc1": { id: "doc1", attributes: {...}, meta: {...} } }
-* };
-*
-* const from = {
-*   type: "items",
-*   latest: "2025-01-01T00:05:00.000Z|0001|c3d4",
-*   resources: {
-*     "doc1": { id: "doc1", attributes: {...}, meta: {...} }, // updated
-*     "doc2": { id: "doc2", attributes: {...}, meta: {...} }  // new
-*   }
-* };
-*
-* const result = mergeDocuments(into, from);
-* // result.document.latest === "2025-01-01T00:05:00.000Z|0001|c3d4"
-* // result.changes.added has "doc2"
-* // result.changes.updated has "doc1"
-* ```
-*/
-function mergeDocuments(into, from) {
-	const added = /* @__PURE__ */ new Map();
-	const updated = /* @__PURE__ */ new Map();
-	const deleted = /* @__PURE__ */ new Set();
-	const mergedResources = { ...into.resources };
-	let newestEventstamp = into.latest >= from.latest ? into.latest : from.latest;
-	for (const [id, fromDoc] of Object.entries(from.resources)) {
-		const intoDoc = into.resources[id];
-		if (!intoDoc) {
-			mergedResources[id] = fromDoc;
-			if (!fromDoc.meta.deletedAt) added.set(id, fromDoc);
-			if (fromDoc.meta.latest > newestEventstamp) newestEventstamp = fromDoc.meta.latest;
-		} else {
-			if (intoDoc === fromDoc) continue;
-			const mergedDoc = mergeResources(intoDoc, fromDoc);
-			mergedResources[id] = mergedDoc;
-			if (mergedDoc.meta.latest > newestEventstamp) newestEventstamp = mergedDoc.meta.latest;
-			const wasDeleted = intoDoc.meta.deletedAt !== null;
-			const isDeleted = mergedDoc.meta.deletedAt !== null;
-			if (!wasDeleted && isDeleted) deleted.add(id);
-			else if (!isDeleted) {
-				if (intoDoc.meta.latest !== mergedDoc.meta.latest) updated.set(id, mergedDoc);
-			}
-		}
-	}
-	return {
-		document: {
-			type: into.type,
-			latest: newestEventstamp,
-			resources: mergedResources
-		},
-		changes: {
-			added,
-			updated,
-			deleted
-		}
-	};
-}
-/**
-* Creates an empty Starling document with the given type and eventstamp.
-* Useful for initializing new stores or testing.
-*
-* @param type - Resource type identifier for this collection
-* @param eventstamp - Initial clock value for this document
-* @returns Empty document
-*
-* @example
-* ```typescript
-* const empty = makeDocument("tasks", "2025-01-01T00:00:00.000Z|0000|0000");
-* ```
-*/
-function makeDocument(type, eventstamp) {
-	return {
-		type,
-		latest: eventstamp,
-		resources: {}
-	};
-}
-
-//#endregion
-//#region src/core/document/utils.ts
-/**
-* Convert a StarlingDocument's resources into a Map keyed by resource ID.
-* @param document - StarlingDocument containing resource data
-* @returns Map of resource ID to ResourceObject
-*/
-function documentToMap(document) {
-	return new Map(Object.entries(document.resources));
-}
-/**
-* Convert a Map of resources into a StarlingDocument.
-* @param type - Resource type identifier for this collection
-* @param resources - Map of resource ID to ResourceObject
-* @param fallbackEventstamp - Eventstamp to include when computing the max (optional)
-* @returns StarlingDocument representation of the resources
-*/
-function mapToDocument(type, resources, fallbackEventstamp) {
-	const eventstamps = Array.from(resources.values()).map((r) => r.meta.latest);
-	if (fallbackEventstamp) eventstamps.push(fallbackEventstamp);
-	const latest = maxEventstamp(eventstamps);
-	const resourcesRecord = {};
-	for (const [id, resource] of resources) resourcesRecord[id] = resource;
-	return {
-		type,
-		latest,
-		resources: resourcesRecord
-	};
-}
-
-//#endregion
-//#region src/core/resource-map/resource-map.ts
-/**
-* A ResourceMap container for storing and managing ResourceObjects.
-*
-* This factory function creates a ResourceMap with state-based replication
-* and automatic convergence via Last-Write-Wins conflict resolution.
-* It stores complete resource snapshots with encoded metadata, including deletion markers.
-*
-* ResourceMap does NOT filter based on deletion status—it stores and returns
-* all ResourceObjects including deleted ones. The Store class is responsible
-* for filtering what's visible to users.
-*
-* @example
-* ```typescript
-* const resourceMap = createMap("todos");
-* resourceMap.set("id1", { name: "Alice" });
-* const resource = resourceMap.get("id1"); // ResourceObject with metadata
-* ```
-*/
-function createMap(resourceType, initialMap = /* @__PURE__ */ new Map(), eventstamp) {
-	let internalMap = initialMap;
-	const clock = createClock();
-	if (eventstamp) clock.forward(eventstamp);
-	return {
-		has(id) {
-			return internalMap.has(id);
-		},
-		get(id) {
-			return internalMap.get(id);
-		},
-		entries() {
-			return internalMap.entries();
-		},
-		set(id, object) {
-			const encoded = makeResource(id, object, clock.now());
-			const current = internalMap.get(id);
-			if (current) {
-				const merged = mergeResources(current, encoded);
-				internalMap.set(id, merged);
-			} else internalMap.set(id, encoded);
-		},
-		delete(id) {
-			const current = internalMap.get(id);
-			if (current) {
-				const doc = deleteResource(current, clock.now());
-				internalMap.set(id, doc);
-			}
-		},
-		cloneMap() {
-			return new Map(internalMap);
-		},
-		toDocument() {
-			return mapToDocument(resourceType, internalMap, clock.latest());
-		},
-		merge(document) {
-			const result = mergeDocuments(mapToDocument(resourceType, internalMap, clock.latest()), document);
-			clock.forward(result.document.latest);
-			internalMap = documentToMap(result.document);
-			return result;
-		}
-	};
-}
-/**
-* Create a ResourceMap from a StarlingDocument snapshot.
-* @param document - StarlingDocument containing resource data
-*/
-function createMapFromDocument(document) {
-	return createMap(document.type, documentToMap(document), document.latest);
-}
-
-//#endregion
-export { makeDocument as a, makeResource as c, createClockFromEventstamp as d, MIN_EVENTSTAMP as f, InvalidEventstampError as h, mapToDocument as i, mergeResources as l, maxEventstamp as m, createMapFromDocument as n, mergeDocuments as o, isValidEventstamp as p, documentToMap as r, deleteResource as s, createMap as t, createClock as u };

package/dist/core.d.ts

@@ -1,2 +0,0 @@
-import { _ as maxEventstamp, a as AnyObject, b as createClock, c as StarlingDocument, d as ResourceObject, f as deleteResource, g as isValidEventstamp, h as MIN_EVENTSTAMP, i as mapToDocument, l as makeDocument, m as mergeResources, n as createMapFromDocument, o as DocumentChanges, p as makeResource, r as documentToMap, s as MergeDocumentsResult, t as createMap, u as mergeDocuments, v as InvalidEventstampError, x as createClockFromEventstamp, y as Clock } from "./index-BIpu-1zO.js";
-export { AnyObject, Clock, DocumentChanges, InvalidEventstampError, MIN_EVENTSTAMP, MergeDocumentsResult, ResourceObject, StarlingDocument, createClock, createClockFromEventstamp, createMap, createMapFromDocument, deleteResource, documentToMap, isValidEventstamp, makeDocument, makeResource, mapToDocument, maxEventstamp, mergeDocuments, mergeResources };

package/dist/core.js

@@ -1,3 +0,0 @@
-import { a as makeDocument, c as makeResource, d as createClockFromEventstamp, f as MIN_EVENTSTAMP, h as InvalidEventstampError, i as mapToDocument, l as mergeResources, m as maxEventstamp, n as createMapFromDocument, o as mergeDocuments, p as isValidEventstamp, r as documentToMap, s as deleteResource, t as createMap, u as createClock } from "./core-UUzgRHaU.js";
-
-export { InvalidEventstampError, MIN_EVENTSTAMP, createClock, createClockFromEventstamp, createMap, createMapFromDocument, deleteResource, documentToMap, isValidEventstamp, makeDocument, makeResource, mapToDocument, maxEventstamp, mergeDocuments, mergeResources };