@dxos/echo 0.8.4-main.c4373fc → 0.8.4-main.c85a9c8dae
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -4
- package/dist/lib/neutral/Annotation.mjs +37 -0
- package/dist/lib/neutral/Database.mjs +45 -0
- package/dist/lib/neutral/Entity.mjs +56 -0
- package/dist/lib/neutral/Err.mjs +12 -0
- package/dist/lib/neutral/Feed.mjs +43 -0
- package/dist/lib/neutral/Filter.mjs +61 -0
- package/dist/lib/neutral/Format.mjs +66 -0
- package/dist/lib/neutral/Format.mjs.map +7 -0
- package/dist/lib/neutral/JsonSchema.mjs +18 -0
- package/dist/lib/neutral/JsonSchema.mjs.map +7 -0
- package/dist/lib/neutral/Key.mjs +12 -0
- package/dist/lib/neutral/Key.mjs.map +7 -0
- package/dist/lib/neutral/Obj.mjs +107 -0
- package/dist/lib/neutral/Obj.mjs.map +7 -0
- package/dist/lib/neutral/Order.mjs +12 -0
- package/dist/lib/neutral/Order.mjs.map +7 -0
- package/dist/lib/neutral/Query.mjs +32 -0
- package/dist/lib/neutral/Query.mjs.map +7 -0
- package/dist/lib/neutral/QueryResult.mjs +2 -0
- package/dist/lib/neutral/QueryResult.mjs.map +7 -0
- package/dist/lib/neutral/Ref.mjs +24 -0
- package/dist/lib/neutral/Ref.mjs.map +7 -0
- package/dist/lib/neutral/Relation.mjs +90 -0
- package/dist/lib/neutral/Relation.mjs.map +7 -0
- package/dist/lib/neutral/SchemaRegistry.mjs +2 -0
- package/dist/lib/neutral/SchemaRegistry.mjs.map +7 -0
- package/dist/lib/neutral/Tag.mjs +25 -0
- package/dist/lib/neutral/Tag.mjs.map +7 -0
- package/dist/lib/neutral/Type.mjs +34 -0
- package/dist/lib/neutral/Type.mjs.map +7 -0
- package/dist/lib/neutral/chunk-4KG6IGL4.mjs +67 -0
- package/dist/lib/neutral/chunk-4KG6IGL4.mjs.map +7 -0
- package/dist/lib/neutral/chunk-5ELDDYWE.mjs +130 -0
- package/dist/lib/neutral/chunk-5ELDDYWE.mjs.map +7 -0
- package/dist/lib/neutral/chunk-ALOGSVBP.mjs +299 -0
- package/dist/lib/neutral/chunk-ALOGSVBP.mjs.map +7 -0
- package/dist/lib/neutral/chunk-ANHVGJI4.mjs +21 -0
- package/dist/lib/neutral/chunk-ANHVGJI4.mjs.map +7 -0
- package/dist/lib/neutral/chunk-AQP4QKYP.mjs +283 -0
- package/dist/lib/neutral/chunk-AQP4QKYP.mjs.map +7 -0
- package/dist/lib/neutral/chunk-BRJSLACP.mjs +152 -0
- package/dist/lib/neutral/chunk-BRJSLACP.mjs.map +7 -0
- package/dist/lib/neutral/chunk-DZQSL6RW.mjs +73 -0
- package/dist/lib/neutral/chunk-DZQSL6RW.mjs.map +7 -0
- package/dist/lib/neutral/chunk-F7KMHDPJ.mjs +327 -0
- package/dist/lib/neutral/chunk-F7KMHDPJ.mjs.map +7 -0
- package/dist/lib/neutral/chunk-GAWKQ5DZ.mjs +56 -0
- package/dist/lib/neutral/chunk-GAWKQ5DZ.mjs.map +7 -0
- package/dist/lib/neutral/chunk-GFNCSK7F.mjs +101 -0
- package/dist/lib/neutral/chunk-GFNCSK7F.mjs.map +7 -0
- package/dist/lib/neutral/chunk-J5LGTIGS.mjs +10 -0
- package/dist/lib/neutral/chunk-J5LGTIGS.mjs.map +7 -0
- package/dist/lib/neutral/chunk-KGV3QIRX.mjs +313 -0
- package/dist/lib/neutral/chunk-KGV3QIRX.mjs.map +7 -0
- package/dist/lib/neutral/chunk-M2KVTHZM.mjs +402 -0
- package/dist/lib/neutral/chunk-M2KVTHZM.mjs.map +7 -0
- package/dist/lib/neutral/chunk-MXQJZCPY.mjs +51 -0
- package/dist/lib/neutral/chunk-MXQJZCPY.mjs.map +7 -0
- package/dist/lib/neutral/chunk-O3TZFQCT.mjs +27 -0
- package/dist/lib/neutral/chunk-O3TZFQCT.mjs.map +7 -0
- package/dist/lib/neutral/chunk-OMUPQMLR.mjs +7 -0
- package/dist/lib/neutral/chunk-OMUPQMLR.mjs.map +7 -0
- package/dist/lib/neutral/chunk-OVUBTQLT.mjs +45 -0
- package/dist/lib/neutral/chunk-OVUBTQLT.mjs.map +7 -0
- package/dist/lib/neutral/chunk-PP4DNUZU.mjs +3919 -0
- package/dist/lib/neutral/chunk-PP4DNUZU.mjs.map +7 -0
- package/dist/lib/neutral/chunk-QXF3LGN2.mjs +43 -0
- package/dist/lib/neutral/chunk-QXF3LGN2.mjs.map +7 -0
- package/dist/lib/neutral/chunk-T4MPQJ7X.mjs +97 -0
- package/dist/lib/neutral/chunk-T4MPQJ7X.mjs.map +7 -0
- package/dist/lib/neutral/chunk-T6JEFNP6.mjs +7 -0
- package/dist/lib/neutral/chunk-T6JEFNP6.mjs.map +7 -0
- package/dist/lib/neutral/chunk-W7OP5HGZ.mjs +121 -0
- package/dist/lib/neutral/chunk-W7OP5HGZ.mjs.map +7 -0
- package/dist/lib/neutral/chunk-ZTUBYOGB.mjs +42 -0
- package/dist/lib/neutral/chunk-ZTUBYOGB.mjs.map +7 -0
- package/dist/lib/neutral/chunk-ZWKJ4LZJ.mjs +298 -0
- package/dist/lib/neutral/chunk-ZWKJ4LZJ.mjs.map +7 -0
- package/dist/lib/neutral/index.mjs +94 -0
- package/dist/lib/neutral/index.mjs.map +7 -0
- package/dist/lib/{node-esm → neutral}/internal/index.mjs +260 -122
- package/dist/lib/neutral/internal/index.mjs.map +7 -0
- package/dist/lib/neutral/meta.json +1 -0
- package/dist/lib/neutral/testing/index.mjs +369 -0
- package/dist/lib/neutral/testing/index.mjs.map +7 -0
- package/dist/types/src/Annotation.d.ts +24 -0
- package/dist/types/src/Annotation.d.ts.map +1 -0
- package/dist/types/src/Collection.d.ts +16 -0
- package/dist/types/src/Collection.d.ts.map +1 -0
- package/dist/types/src/Database.d.ts +189 -0
- package/dist/types/src/Database.d.ts.map +1 -0
- package/dist/types/src/Dataset.d.ts +18 -0
- package/dist/types/src/Dataset.d.ts.map +1 -0
- package/dist/types/src/Entity.d.ts +168 -0
- package/dist/types/src/Entity.d.ts.map +1 -0
- package/dist/types/src/Entity.test.d.ts +2 -0
- package/dist/types/src/Entity.test.d.ts.map +1 -0
- package/dist/types/src/Err.d.ts +107 -0
- package/dist/types/src/Err.d.ts.map +1 -0
- package/dist/types/src/Feed.d.ts +165 -0
- package/dist/types/src/Feed.d.ts.map +1 -0
- package/dist/types/src/Filter.d.ts +120 -0
- package/dist/types/src/Filter.d.ts.map +1 -0
- package/dist/types/src/Format.d.ts +4 -0
- package/dist/types/src/Format.d.ts.map +1 -0
- package/dist/types/src/Hypergraph.d.ts +60 -0
- package/dist/types/src/Hypergraph.d.ts.map +1 -0
- package/dist/types/src/JsonSchema.d.ts +16 -0
- package/dist/types/src/JsonSchema.d.ts.map +1 -0
- package/dist/types/src/Key.d.ts +1 -0
- package/dist/types/src/Key.d.ts.map +1 -1
- package/dist/types/src/Obj.d.ts +423 -95
- package/dist/types/src/Obj.d.ts.map +1 -1
- package/dist/types/src/Obj.test.d.ts +2 -0
- package/dist/types/src/Obj.test.d.ts.map +1 -0
- package/dist/types/src/Order.d.ts +16 -0
- package/dist/types/src/Order.d.ts.map +1 -0
- package/dist/types/src/Query.d.ts +202 -0
- package/dist/types/src/Query.d.ts.map +1 -0
- package/dist/types/src/Query.test.d.ts +2 -0
- package/dist/types/src/Query.test.d.ts.map +1 -0
- package/dist/types/src/QueryResult.d.ts +80 -0
- package/dist/types/src/QueryResult.d.ts.map +1 -0
- package/dist/types/src/Ref.d.ts +61 -11
- package/dist/types/src/Ref.d.ts.map +1 -1
- package/dist/types/src/Relation.d.ts +287 -21
- package/dist/types/src/Relation.d.ts.map +1 -1
- package/dist/types/src/Relation.test.d.ts +2 -0
- package/dist/types/src/Relation.test.d.ts.map +1 -0
- package/dist/types/src/SchemaRegistry.d.ts +84 -0
- package/dist/types/src/SchemaRegistry.d.ts.map +1 -0
- package/dist/types/src/Tag.d.ts +18 -0
- package/dist/types/src/Tag.d.ts.map +1 -0
- package/dist/types/src/Type.d.ts +120 -97
- package/dist/types/src/Type.d.ts.map +1 -1
- package/dist/types/src/Type.test.d.ts +2 -0
- package/dist/types/src/Type.test.d.ts.map +1 -0
- package/dist/types/src/View.d.ts +68 -0
- package/dist/types/src/View.d.ts.map +1 -0
- package/dist/types/src/hierarchy.test.d.ts +2 -0
- package/dist/types/src/hierarchy.test.d.ts.map +1 -0
- package/dist/types/src/index.d.ts +19 -5
- package/dist/types/src/index.d.ts.map +1 -1
- package/dist/types/src/internal/annotations/annotations.d.ts +209 -0
- package/dist/types/src/internal/annotations/annotations.d.ts.map +1 -0
- package/dist/types/src/internal/annotations/annotations.test.d.ts.map +1 -0
- package/dist/types/src/internal/annotations/index.d.ts +3 -0
- package/dist/types/src/internal/annotations/index.d.ts.map +1 -0
- package/dist/types/src/internal/annotations/util.d.ts +39 -0
- package/dist/types/src/internal/annotations/util.d.ts.map +1 -0
- package/dist/types/src/internal/api/annotations.d.ts +23 -0
- package/dist/types/src/internal/api/annotations.d.ts.map +1 -0
- package/dist/types/src/internal/api/entity.d.ts +13 -0
- package/dist/types/src/internal/api/entity.d.ts.map +1 -0
- package/dist/types/src/internal/api/index.d.ts +15 -0
- package/dist/types/src/internal/api/index.d.ts.map +1 -0
- package/dist/types/src/internal/api/meta.d.ts +42 -0
- package/dist/types/src/internal/api/meta.d.ts.map +1 -0
- package/dist/types/src/internal/api/sorting.d.ts +24 -0
- package/dist/types/src/internal/api/sorting.d.ts.map +1 -0
- package/dist/types/src/internal/api/version.d.ts +42 -0
- package/dist/types/src/internal/api/version.d.ts.map +1 -0
- package/dist/types/src/internal/entities/entity.d.ts +20 -0
- package/dist/types/src/internal/entities/entity.d.ts.map +1 -0
- package/dist/types/src/internal/entities/index.d.ts +6 -0
- package/dist/types/src/internal/entities/index.d.ts.map +1 -0
- package/dist/types/src/internal/entities/model.d.ts +79 -0
- package/dist/types/src/internal/entities/model.d.ts.map +1 -0
- package/dist/types/src/internal/entities/object.d.ts +18 -0
- package/dist/types/src/internal/entities/object.d.ts.map +1 -0
- package/dist/types/src/internal/entities/relation.d.ts +62 -0
- package/dist/types/src/internal/entities/relation.d.ts.map +1 -0
- package/dist/types/src/internal/entities/util.d.ts +2 -0
- package/dist/types/src/internal/entities/util.d.ts.map +1 -0
- package/dist/types/src/internal/formats/format.d.ts +4 -2
- package/dist/types/src/internal/formats/format.d.ts.map +1 -1
- package/dist/types/src/internal/formats/select.d.ts +6 -4
- package/dist/types/src/internal/formats/select.d.ts.map +1 -1
- package/dist/types/src/internal/formats/string.d.ts +4 -0
- package/dist/types/src/internal/formats/string.d.ts.map +1 -1
- package/dist/types/src/internal/formats/types.d.ts +13 -9
- package/dist/types/src/internal/formats/types.d.ts.map +1 -1
- package/dist/types/src/internal/index.d.ts +7 -10
- package/dist/types/src/internal/index.d.ts.map +1 -1
- package/dist/types/src/internal/json-schema/annotations.d.ts.map +1 -0
- package/dist/types/src/internal/json-schema/effect-schema.test.d.ts.map +1 -0
- package/dist/types/src/internal/json-schema/index.d.ts +2 -0
- package/dist/types/src/internal/json-schema/index.d.ts.map +1 -1
- package/dist/types/src/internal/json-schema/json-schema-normalize.d.ts.map +1 -1
- package/dist/types/src/internal/json-schema/json-schema-type.d.ts +130 -29
- package/dist/types/src/internal/json-schema/json-schema-type.d.ts.map +1 -1
- package/dist/types/src/internal/{json → json-schema}/json-schema.d.ts +4 -6
- package/dist/types/src/internal/json-schema/json-schema.d.ts.map +1 -0
- package/dist/types/src/internal/json-schema/json-schema.test.d.ts.map +1 -0
- package/dist/types/src/internal/object/clone.d.ts +8 -0
- package/dist/types/src/internal/object/clone.d.ts.map +1 -0
- package/dist/types/src/internal/object/common.d.ts.map +1 -1
- package/dist/types/src/internal/object/{create.d.ts → create-object.d.ts} +10 -11
- package/dist/types/src/internal/object/create-object.d.ts.map +1 -0
- package/dist/types/src/internal/object/create-object.test.d.ts +2 -0
- package/dist/types/src/internal/object/create-object.test.d.ts.map +1 -0
- package/dist/types/src/internal/object/deleted.d.ts +2 -2
- package/dist/types/src/internal/object/deleted.d.ts.map +1 -1
- package/dist/types/src/internal/object/ids.d.ts.map +1 -1
- package/dist/types/src/internal/object/index.d.ts +6 -12
- package/dist/types/src/internal/object/index.d.ts.map +1 -1
- package/dist/types/src/internal/object/json-serializer.d.ts +14 -9
- package/dist/types/src/internal/object/json-serializer.d.ts.map +1 -1
- package/dist/types/src/internal/object/schema-validator.d.ts +1 -14
- package/dist/types/src/internal/object/schema-validator.d.ts.map +1 -1
- package/dist/types/src/internal/object/set-value.d.ts +7 -0
- package/dist/types/src/internal/object/set-value.d.ts.map +1 -0
- package/dist/types/src/internal/object/set-value.test.d.ts +2 -0
- package/dist/types/src/internal/object/set-value.test.d.ts.map +1 -0
- package/dist/types/src/internal/object/snapshot.d.ts +6 -0
- package/dist/types/src/internal/object/snapshot.d.ts.map +1 -0
- package/dist/types/src/internal/object/typed-object.d.ts +8 -14
- package/dist/types/src/internal/object/typed-object.d.ts.map +1 -1
- package/dist/types/src/internal/proxy/change-context.d.ts +55 -0
- package/dist/types/src/internal/proxy/change-context.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/change.test.d.ts +2 -0
- package/dist/types/src/internal/proxy/change.test.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/define-hidden-property.d.ts +5 -0
- package/dist/types/src/internal/proxy/define-hidden-property.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/errors.d.ts +19 -0
- package/dist/types/src/internal/proxy/errors.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/event-batch.d.ts +10 -0
- package/dist/types/src/internal/proxy/event-batch.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/index.d.ts +14 -0
- package/dist/types/src/internal/proxy/index.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/json-serializer.d.ts +6 -0
- package/dist/types/src/internal/proxy/json-serializer.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/make-object.d.ts +14 -0
- package/dist/types/src/internal/proxy/make-object.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/ownership.d.ts +57 -0
- package/dist/types/src/internal/proxy/ownership.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/proxy-types.d.ts +18 -0
- package/dist/types/src/internal/proxy/proxy-types.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/proxy-utils.d.ts +47 -0
- package/dist/types/src/internal/proxy/proxy-utils.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/reactive-array.d.ts +8 -0
- package/dist/types/src/internal/proxy/reactive-array.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/reactive.d.ts +39 -0
- package/dist/types/src/internal/proxy/reactive.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/schema-validator.d.ts +15 -0
- package/dist/types/src/internal/proxy/schema-validator.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/symbols.d.ts +3 -0
- package/dist/types/src/internal/proxy/symbols.d.ts.map +1 -0
- package/dist/types/src/internal/proxy/typed-handler.d.ts +16 -12
- package/dist/types/src/internal/proxy/typed-handler.d.ts.map +1 -1
- package/dist/types/src/internal/ref/ref-array.d.ts +4 -4
- package/dist/types/src/internal/ref/ref-array.d.ts.map +1 -1
- package/dist/types/src/internal/ref/ref.d.ts +43 -18
- package/dist/types/src/internal/ref/ref.d.ts.map +1 -1
- package/dist/types/src/internal/schema/compose.d.ts +7 -0
- package/dist/types/src/internal/schema/compose.d.ts.map +1 -0
- package/dist/types/src/internal/schema/compose.test.d.ts.map +1 -0
- package/dist/types/src/internal/schema/echo-schema.d.ts +25 -12
- package/dist/types/src/internal/schema/echo-schema.d.ts.map +1 -1
- package/dist/types/src/internal/schema/index.d.ts +1 -4
- package/dist/types/src/internal/schema/index.d.ts.map +1 -1
- package/dist/types/src/internal/schema/manipulation.d.ts.map +1 -1
- package/dist/types/src/internal/schema/persistent-schema.d.ts +20 -0
- package/dist/types/src/internal/schema/persistent-schema.d.ts.map +1 -0
- package/dist/types/src/internal/types/base.d.ts +27 -0
- package/dist/types/src/internal/types/base.d.ts.map +1 -0
- package/dist/types/src/internal/types/entity.d.ts +37 -0
- package/dist/types/src/internal/types/entity.d.ts.map +1 -0
- package/dist/types/src/internal/types/index.d.ts +5 -2
- package/dist/types/src/internal/types/index.d.ts.map +1 -1
- package/dist/types/src/internal/{object → types}/meta.d.ts +16 -14
- package/dist/types/src/internal/types/meta.d.ts.map +1 -0
- package/dist/types/src/internal/types/typename.d.ts +21 -0
- package/dist/types/src/internal/types/typename.d.ts.map +1 -0
- package/dist/types/src/internal/types/version.d.ts +15 -0
- package/dist/types/src/internal/types/version.d.ts.map +1 -0
- package/dist/types/src/{test → testing}/api.test.d.ts.map +1 -1
- package/dist/types/src/testing/index.d.ts +3 -3
- package/dist/types/src/testing/index.d.ts.map +1 -1
- package/dist/types/src/testing/test-data.d.ts +18 -0
- package/dist/types/src/testing/test-data.d.ts.map +1 -0
- package/dist/types/src/testing/test-schema.d.ts +304 -0
- package/dist/types/src/testing/test-schema.d.ts.map +1 -0
- package/dist/types/src/testing/util.d.ts +21 -0
- package/dist/types/src/testing/util.d.ts.map +1 -0
- package/dist/types/tsconfig.tsbuildinfo +1 -1
- package/package.json +106 -65
- package/src/Annotation.ts +46 -0
- package/src/Collection.ts +30 -0
- package/src/Database.ts +315 -0
- package/src/Dataset.ts +24 -0
- package/src/Entity.test.ts +22 -0
- package/src/Entity.ts +234 -0
- package/src/Err.ts +38 -0
- package/src/Feed.ts +254 -0
- package/src/Filter.ts +389 -0
- package/src/Format.ts +9 -0
- package/src/Hypergraph.ts +74 -0
- package/src/JsonSchema.ts +24 -0
- package/src/Key.ts +3 -0
- package/src/Obj.test.ts +447 -0
- package/src/Obj.ts +588 -248
- package/src/Order.ts +44 -0
- package/src/Query.test.ts +632 -0
- package/src/Query.ts +520 -0
- package/src/QueryResult.ts +106 -0
- package/src/Ref.ts +77 -9
- package/src/Relation.test.ts +88 -0
- package/src/Relation.ts +440 -58
- package/src/SchemaRegistry.ts +106 -0
- package/src/Tag.ts +39 -0
- package/src/Type.test.ts +52 -0
- package/src/Type.ts +162 -151
- package/src/View.ts +100 -0
- package/src/hierarchy.test.ts +33 -0
- package/src/index.ts +20 -6
- package/src/internal/README.md +102 -0
- package/src/internal/{ast → annotations}/annotations.test.ts +18 -20
- package/src/internal/annotations/annotations.ts +526 -0
- package/src/internal/annotations/index.ts +6 -0
- package/src/internal/annotations/util.ts +85 -0
- package/src/internal/api/annotations.ts +60 -0
- package/src/internal/api/entity.ts +29 -0
- package/src/internal/api/index.ts +19 -0
- package/src/internal/api/meta.ts +88 -0
- package/src/internal/api/sorting.ts +53 -0
- package/src/internal/api/version.ts +96 -0
- package/src/internal/entities/entity.ts +128 -0
- package/src/internal/entities/index.ts +9 -0
- package/src/internal/entities/model.ts +138 -0
- package/src/internal/entities/object.ts +58 -0
- package/src/internal/entities/relation.ts +171 -0
- package/src/internal/entities/util.ts +33 -0
- package/src/internal/formats/date.test.ts +1 -1
- package/src/internal/formats/date.ts +5 -5
- package/src/internal/formats/format.test.ts +6 -6
- package/src/internal/formats/format.ts +8 -6
- package/src/internal/formats/number.ts +5 -5
- package/src/internal/formats/object.ts +4 -4
- package/src/internal/formats/select.ts +6 -4
- package/src/internal/formats/string.ts +14 -9
- package/src/internal/formats/types.ts +53 -42
- package/src/internal/index.ts +30 -13
- package/src/internal/{json → json-schema}/annotations.ts +1 -1
- package/src/internal/json-schema/index.ts +2 -0
- package/src/internal/json-schema/json-schema-normalize.ts +4 -2
- package/src/internal/json-schema/json-schema-type.ts +35 -35
- package/src/internal/{json → json-schema}/json-schema.test.ts +232 -97
- package/src/internal/{json → json-schema}/json-schema.ts +79 -93
- package/src/internal/object/clone.ts +48 -0
- package/src/internal/object/common.ts +3 -4
- package/src/internal/object/{create.test.ts → create-object.test.ts} +31 -33
- package/src/internal/object/{create.ts → create-object.ts} +36 -37
- package/src/internal/object/deleted.ts +6 -6
- package/src/internal/object/ids.ts +1 -1
- package/src/internal/object/index.ts +6 -12
- package/src/internal/object/inspect.ts +5 -7
- package/src/internal/object/json-serializer.test.ts +59 -37
- package/src/internal/object/json-serializer.ts +87 -108
- package/src/internal/object/schema-validator.test.ts +3 -7
- package/src/internal/object/schema-validator.ts +2 -237
- package/src/internal/object/set-value.test.ts +281 -0
- package/src/internal/object/set-value.ts +165 -0
- package/src/internal/object/snapshot.ts +96 -0
- package/src/internal/object/typed-object.test.ts +11 -11
- package/src/internal/object/typed-object.ts +8 -59
- package/src/internal/proxy/change-context.ts +138 -0
- package/src/internal/proxy/change.test.ts +519 -0
- package/src/internal/proxy/define-hidden-property.ts +14 -0
- package/src/internal/proxy/errors.ts +42 -0
- package/src/internal/proxy/event-batch.ts +44 -0
- package/src/internal/proxy/handler.test.ts +51 -91
- package/src/internal/proxy/index.ts +17 -0
- package/src/internal/proxy/json-serializer.ts +87 -0
- package/src/internal/proxy/make-object.ts +106 -0
- package/src/internal/proxy/ownership.ts +253 -0
- package/src/internal/proxy/proxy-types.ts +23 -0
- package/src/internal/proxy/proxy-utils.ts +150 -0
- package/src/internal/proxy/reactive-array.ts +71 -0
- package/src/internal/proxy/reactive.ts +69 -0
- package/src/internal/proxy/schema-validator.ts +244 -0
- package/src/internal/proxy/schema.test.ts +27 -18
- package/src/internal/proxy/symbols.ts +7 -0
- package/src/internal/proxy/typed-handler.test.ts +260 -48
- package/src/internal/proxy/typed-handler.ts +283 -61
- package/src/internal/proxy/typed-object.test.ts +54 -38
- package/src/internal/ref/ref-array.ts +4 -4
- package/src/internal/ref/ref.test.ts +10 -9
- package/src/internal/ref/ref.ts +107 -56
- package/src/internal/{projection → schema}/compose.test.ts +8 -9
- package/src/internal/{projection → schema}/compose.ts +13 -8
- package/src/internal/schema/echo-schema.ts +74 -33
- package/src/internal/schema/index.ts +1 -4
- package/src/internal/schema/manipulation.ts +7 -1
- package/src/internal/schema/persistent-schema.ts +33 -0
- package/src/internal/types/base.ts +43 -0
- package/src/internal/types/entity.ts +54 -0
- package/src/internal/types/index.ts +5 -2
- package/src/internal/types/meta.ts +68 -0
- package/src/internal/types/typename.ts +55 -0
- package/src/internal/types/version.ts +19 -0
- package/src/testing/api.test.ts +126 -0
- package/src/testing/index.ts +3 -3
- package/src/testing/test-data.ts +130 -0
- package/src/testing/test-schema.ts +240 -0
- package/src/testing/util.ts +85 -0
- package/dist/lib/browser/chunk-MWLA34S5.mjs +0 -3843
- package/dist/lib/browser/chunk-MWLA34S5.mjs.map +0 -7
- package/dist/lib/browser/chunk-OAZJQHVO.mjs +0 -453
- package/dist/lib/browser/chunk-OAZJQHVO.mjs.map +0 -7
- package/dist/lib/browser/chunk-ORIE2FMS.mjs +0 -514
- package/dist/lib/browser/chunk-ORIE2FMS.mjs.map +0 -7
- package/dist/lib/browser/index.mjs +0 -43
- package/dist/lib/browser/internal/index.mjs +0 -326
- package/dist/lib/browser/meta.json +0 -1
- package/dist/lib/browser/query/index.mjs +0 -23
- package/dist/lib/browser/testing/index.mjs +0 -298
- package/dist/lib/browser/testing/index.mjs.map +0 -7
- package/dist/lib/node-esm/chunk-AXWVDOP7.mjs +0 -453
- package/dist/lib/node-esm/chunk-AXWVDOP7.mjs.map +0 -7
- package/dist/lib/node-esm/chunk-L4PBAJDP.mjs +0 -514
- package/dist/lib/node-esm/chunk-L4PBAJDP.mjs.map +0 -7
- package/dist/lib/node-esm/chunk-YTNLFBIK.mjs +0 -3843
- package/dist/lib/node-esm/chunk-YTNLFBIK.mjs.map +0 -7
- package/dist/lib/node-esm/index.mjs +0 -43
- package/dist/lib/node-esm/meta.json +0 -1
- package/dist/lib/node-esm/query/index.mjs +0 -23
- package/dist/lib/node-esm/testing/index.mjs +0 -298
- package/dist/lib/node-esm/testing/index.mjs.map +0 -7
- package/dist/types/src/errors.d.ts +0 -72
- package/dist/types/src/errors.d.ts.map +0 -1
- package/dist/types/src/internal/ast/annotation-helper.d.ts +0 -8
- package/dist/types/src/internal/ast/annotation-helper.d.ts.map +0 -1
- package/dist/types/src/internal/ast/annotations.d.ts +0 -119
- package/dist/types/src/internal/ast/annotations.d.ts.map +0 -1
- package/dist/types/src/internal/ast/annotations.test.d.ts.map +0 -1
- package/dist/types/src/internal/ast/entity-kind.d.ts +0 -10
- package/dist/types/src/internal/ast/entity-kind.d.ts.map +0 -1
- package/dist/types/src/internal/ast/index.d.ts +0 -5
- package/dist/types/src/internal/ast/index.d.ts.map +0 -1
- package/dist/types/src/internal/ast/types.d.ts +0 -6
- package/dist/types/src/internal/ast/types.d.ts.map +0 -1
- package/dist/types/src/internal/json/annotations.d.ts.map +0 -1
- package/dist/types/src/internal/json/effect-schema.test.d.ts.map +0 -1
- package/dist/types/src/internal/json/index.d.ts +0 -2
- package/dist/types/src/internal/json/index.d.ts.map +0 -1
- package/dist/types/src/internal/json/json-schema.d.ts.map +0 -1
- package/dist/types/src/internal/json/json-schema.test.d.ts.map +0 -1
- package/dist/types/src/internal/object/accessors.d.ts +0 -29
- package/dist/types/src/internal/object/accessors.d.ts.map +0 -1
- package/dist/types/src/internal/object/create.d.ts.map +0 -1
- package/dist/types/src/internal/object/create.test.d.ts +0 -2
- package/dist/types/src/internal/object/create.test.d.ts.map +0 -1
- package/dist/types/src/internal/object/entity.d.ts +0 -22
- package/dist/types/src/internal/object/entity.d.ts.map +0 -1
- package/dist/types/src/internal/object/expando.d.ts +0 -14
- package/dist/types/src/internal/object/expando.d.ts.map +0 -1
- package/dist/types/src/internal/object/meta.d.ts.map +0 -1
- package/dist/types/src/internal/object/model.d.ts +0 -117
- package/dist/types/src/internal/object/model.d.ts.map +0 -1
- package/dist/types/src/internal/object/relation.d.ts +0 -17
- package/dist/types/src/internal/object/relation.d.ts.map +0 -1
- package/dist/types/src/internal/object/typed-relation.d.ts +0 -32
- package/dist/types/src/internal/object/typed-relation.d.ts.map +0 -1
- package/dist/types/src/internal/object/typename.d.ts +0 -15
- package/dist/types/src/internal/object/typename.d.ts.map +0 -1
- package/dist/types/src/internal/object/version.d.ts +0 -14
- package/dist/types/src/internal/object/version.d.ts.map +0 -1
- package/dist/types/src/internal/projection/compose.d.ts +0 -6
- package/dist/types/src/internal/projection/compose.d.ts.map +0 -1
- package/dist/types/src/internal/projection/compose.test.d.ts.map +0 -1
- package/dist/types/src/internal/projection/index.d.ts +0 -2
- package/dist/types/src/internal/projection/index.d.ts.map +0 -1
- package/dist/types/src/internal/proxy/reactive-object.d.ts +0 -15
- package/dist/types/src/internal/proxy/reactive-object.d.ts.map +0 -1
- package/dist/types/src/internal/query/index.d.ts +0 -2
- package/dist/types/src/internal/query/index.d.ts.map +0 -1
- package/dist/types/src/internal/query/query.d.ts +0 -17
- package/dist/types/src/internal/query/query.d.ts.map +0 -1
- package/dist/types/src/internal/schema/runtime-schema-registry.d.ts +0 -18
- package/dist/types/src/internal/schema/runtime-schema-registry.d.ts.map +0 -1
- package/dist/types/src/internal/schema/snapshot.d.ts +0 -6
- package/dist/types/src/internal/schema/snapshot.d.ts.map +0 -1
- package/dist/types/src/internal/schema/stored-schema.d.ts +0 -13
- package/dist/types/src/internal/schema/stored-schema.d.ts.map +0 -1
- package/dist/types/src/internal/testing/index.d.ts +0 -3
- package/dist/types/src/internal/testing/index.d.ts.map +0 -1
- package/dist/types/src/internal/testing/types.d.ts +0 -455
- package/dist/types/src/internal/testing/types.d.ts.map +0 -1
- package/dist/types/src/internal/testing/utils.d.ts +0 -10
- package/dist/types/src/internal/testing/utils.d.ts.map +0 -1
- package/dist/types/src/internal/types/types.d.ts +0 -79
- package/dist/types/src/internal/types/types.d.ts.map +0 -1
- package/dist/types/src/internal/types/types.test.d.ts +0 -2
- package/dist/types/src/internal/types/types.test.d.ts.map +0 -1
- package/dist/types/src/internal/types/util.d.ts +0 -5
- package/dist/types/src/internal/types/util.d.ts.map +0 -1
- package/dist/types/src/query/index.d.ts +0 -3
- package/dist/types/src/query/index.d.ts.map +0 -1
- package/dist/types/src/query/query.d.ts +0 -247
- package/dist/types/src/query/query.d.ts.map +0 -1
- package/dist/types/src/query/query.test.d.ts +0 -2
- package/dist/types/src/query/query.test.d.ts.map +0 -1
- package/dist/types/src/query/tag.d.ts +0 -18
- package/dist/types/src/query/tag.d.ts.map +0 -1
- package/dist/types/src/testing/echo-schema.d.ts +0 -7
- package/dist/types/src/testing/echo-schema.d.ts.map +0 -1
- package/dist/types/src/testing/types.d.ts +0 -113
- package/dist/types/src/testing/types.d.ts.map +0 -1
- package/src/errors.ts +0 -18
- package/src/internal/ast/annotation-helper.ts +0 -22
- package/src/internal/ast/annotations.ts +0 -212
- package/src/internal/ast/entity-kind.ts +0 -15
- package/src/internal/ast/index.ts +0 -8
- package/src/internal/ast/types.ts +0 -17
- package/src/internal/json/index.ts +0 -5
- package/src/internal/object/accessors.ts +0 -115
- package/src/internal/object/entity.ts +0 -204
- package/src/internal/object/expando.ts +0 -21
- package/src/internal/object/meta.ts +0 -62
- package/src/internal/object/model.ts +0 -170
- package/src/internal/object/relation.ts +0 -24
- package/src/internal/object/typed-relation.ts +0 -85
- package/src/internal/object/typename.ts +0 -61
- package/src/internal/object/version.ts +0 -22
- package/src/internal/projection/index.ts +0 -5
- package/src/internal/proxy/reactive-object.ts +0 -108
- package/src/internal/query/index.ts +0 -5
- package/src/internal/query/query.ts +0 -23
- package/src/internal/schema/runtime-schema-registry.ts +0 -78
- package/src/internal/schema/snapshot.ts +0 -25
- package/src/internal/schema/stored-schema.ts +0 -26
- package/src/internal/testing/index.ts +0 -6
- package/src/internal/testing/types.ts +0 -211
- package/src/internal/testing/utils.ts +0 -54
- package/src/internal/types/types.test.ts +0 -48
- package/src/internal/types/types.ts +0 -176
- package/src/internal/types/util.ts +0 -9
- package/src/query/index.ts +0 -6
- package/src/query/query.test.ts +0 -362
- package/src/query/query.ts +0 -784
- package/src/query/tag.ts +0 -35
- package/src/test/api.test.ts +0 -180
- package/src/testing/echo-schema.ts +0 -39
- package/src/testing/types.ts +0 -91
- /package/dist/lib/{browser/index.mjs.map → neutral/Annotation.mjs.map} +0 -0
- /package/dist/lib/{browser/internal/index.mjs.map → neutral/Database.mjs.map} +0 -0
- /package/dist/lib/{browser/query/index.mjs.map → neutral/Entity.mjs.map} +0 -0
- /package/dist/lib/{node-esm/index.mjs.map → neutral/Err.mjs.map} +0 -0
- /package/dist/lib/{node-esm/internal/index.mjs.map → neutral/Feed.mjs.map} +0 -0
- /package/dist/lib/{node-esm/query/index.mjs.map → neutral/Filter.mjs.map} +0 -0
- /package/dist/types/src/internal/{ast → annotations}/annotations.test.d.ts +0 -0
- /package/dist/types/src/internal/{json → json-schema}/annotations.d.ts +0 -0
- /package/dist/types/src/internal/{json → json-schema}/effect-schema.test.d.ts +0 -0
- /package/dist/types/src/internal/{json → json-schema}/json-schema.test.d.ts +0 -0
- /package/dist/types/src/internal/{projection → schema}/compose.test.d.ts +0 -0
- /package/dist/types/src/{test → testing}/api.test.d.ts +0 -0
- /package/src/internal/{json → json-schema}/effect-schema.test.ts +0 -0
package/src/Tag.ts
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
//
|
|
2
|
+
// Copyright 2025 DXOS.org
|
|
3
|
+
//
|
|
4
|
+
|
|
5
|
+
import * as Schema from 'effect/Schema';
|
|
6
|
+
|
|
7
|
+
import * as internal from './internal';
|
|
8
|
+
import * as Obj from './Obj';
|
|
9
|
+
import * as Type from './Type';
|
|
10
|
+
|
|
11
|
+
export const Tag = Schema.Struct({
|
|
12
|
+
label: Schema.String,
|
|
13
|
+
hue: Schema.optional(Schema.String), // TODO(burdon): Color name?
|
|
14
|
+
}).pipe(
|
|
15
|
+
Type.object({
|
|
16
|
+
typename: 'dxos.org/type/Tag',
|
|
17
|
+
version: '0.1.0',
|
|
18
|
+
}),
|
|
19
|
+
internal.LabelAnnotation.set(['label']),
|
|
20
|
+
internal.SystemTypeAnnotation.set(true),
|
|
21
|
+
);
|
|
22
|
+
|
|
23
|
+
export type Tag = Schema.Schema.Type<typeof Tag>;
|
|
24
|
+
|
|
25
|
+
export const make = (props: Obj.MakeProps<typeof Tag>) => Obj.make(Tag, props);
|
|
26
|
+
|
|
27
|
+
export type Map = Record<string, Tag>;
|
|
28
|
+
|
|
29
|
+
export const sortTags = ({ label: a }: Tag, { label: b }: Tag) => a.localeCompare(b);
|
|
30
|
+
|
|
31
|
+
export const createTagList = (tags: Map): Tag[] =>
|
|
32
|
+
Object.entries(tags)
|
|
33
|
+
.map(([id, tag]) => ({ ...tag, id }))
|
|
34
|
+
.sort(sortTags);
|
|
35
|
+
|
|
36
|
+
export const findTagByLabel = (tags: Map | undefined, name: string): Tag | undefined => {
|
|
37
|
+
const entry = Object.entries(tags ?? {}).find(([_, tag]) => tag.label.toLowerCase() === name.toLowerCase());
|
|
38
|
+
return entry ? { ...entry[1], id: entry[0] } : undefined;
|
|
39
|
+
};
|
package/src/Type.test.ts
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
//
|
|
2
|
+
// Copyright 2026 DXOS.org
|
|
3
|
+
//
|
|
4
|
+
|
|
5
|
+
import * as Schema from 'effect/Schema';
|
|
6
|
+
import { describe, test } from 'vitest';
|
|
7
|
+
|
|
8
|
+
import * as Obj from './Obj';
|
|
9
|
+
import * as Relation from './Relation';
|
|
10
|
+
import { TestSchema } from './testing';
|
|
11
|
+
import * as Type from './Type';
|
|
12
|
+
|
|
13
|
+
describe('Type', () => {
|
|
14
|
+
describe('Obj.Unknown schema', () => {
|
|
15
|
+
test('has SchemaKindId for schema type checking', ({ expect }) => {
|
|
16
|
+
// Type.isObjectSchema uses SchemaKindId to check if a schema is an object schema.
|
|
17
|
+
expect(Type.isObjectSchema(Obj.Unknown)).toBe(true);
|
|
18
|
+
expect(Type.isObjectSchema(TestSchema.Person)).toBe(true);
|
|
19
|
+
expect(Type.isObjectSchema(Relation.Unknown)).toBe(false);
|
|
20
|
+
});
|
|
21
|
+
|
|
22
|
+
test('Schema.is validates structural compatibility only', ({ expect }) => {
|
|
23
|
+
// Schema.is does structural validation (has id field).
|
|
24
|
+
// It accepts both ECHO objects and plain objects with compatible structure.
|
|
25
|
+
expect(Schema.is(Obj.Unknown)({ id: 'plain-object' })).toBe(true);
|
|
26
|
+
const obj = Obj.make(TestSchema.Person, { name: 'Test' });
|
|
27
|
+
expect(Schema.is(Obj.Unknown)(obj)).toBe(true);
|
|
28
|
+
});
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
describe('Relation.Unknown schema', () => {
|
|
32
|
+
test('has SchemaKindId for schema type checking', ({ expect }) => {
|
|
33
|
+
// Type.isRelationSchema uses SchemaKindId to check if a schema is a relation schema.
|
|
34
|
+
expect(Type.isRelationSchema(Relation.Unknown)).toBe(true);
|
|
35
|
+
expect(Type.isRelationSchema(TestSchema.HasManager)).toBe(true);
|
|
36
|
+
expect(Type.isRelationSchema(Obj.Unknown)).toBe(false);
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
test('Schema.is validates structural compatibility only', ({ expect }) => {
|
|
40
|
+
// Schema.is does structural validation (has id field).
|
|
41
|
+
// It accepts both ECHO relations and plain objects with compatible structure.
|
|
42
|
+
expect(Schema.is(Relation.Unknown)({ id: 'plain-object' })).toBe(true);
|
|
43
|
+
const obj1 = Obj.make(TestSchema.Person, { name: 'Alice' });
|
|
44
|
+
const obj2 = Obj.make(TestSchema.Person, { name: 'Bob' });
|
|
45
|
+
const rel = Relation.make(TestSchema.HasManager, {
|
|
46
|
+
[Relation.Source]: obj1,
|
|
47
|
+
[Relation.Target]: obj2,
|
|
48
|
+
});
|
|
49
|
+
expect(Schema.is(Relation.Unknown)(rel)).toBe(true);
|
|
50
|
+
});
|
|
51
|
+
});
|
|
52
|
+
});
|
package/src/Type.ts
CHANGED
|
@@ -2,195 +2,211 @@
|
|
|
2
2
|
// Copyright 2025 DXOS.org
|
|
3
3
|
//
|
|
4
4
|
|
|
5
|
-
import type * as
|
|
5
|
+
import type * as Schema from 'effect/Schema';
|
|
6
6
|
|
|
7
7
|
import { type EncodedReference } from '@dxos/echo-protocol';
|
|
8
8
|
import { invariant } from '@dxos/invariant';
|
|
9
|
-
import type
|
|
9
|
+
import { type DXN } from '@dxos/keys';
|
|
10
|
+
import { type ToMutable } from '@dxos/util';
|
|
10
11
|
|
|
11
|
-
import
|
|
12
|
-
import * as
|
|
12
|
+
import type * as EntityModule from './Entity';
|
|
13
|
+
import * as internal from './internal';
|
|
14
|
+
import type * as ObjModule from './Obj';
|
|
13
15
|
import type * as RelationModule from './Relation';
|
|
14
16
|
|
|
15
|
-
//
|
|
16
|
-
// Kind
|
|
17
|
-
//
|
|
18
|
-
|
|
19
|
-
export const KindId: unique symbol = EchoSchema.EntityKindId as any;
|
|
20
|
-
export type KindId = typeof KindId;
|
|
21
|
-
|
|
22
|
-
export const Kind = EchoSchema.EntityKind;
|
|
23
|
-
|
|
24
17
|
/**
|
|
25
|
-
*
|
|
18
|
+
* Dynamic type that can be constructed, mutated, and persisted in the ECHO database.
|
|
26
19
|
*/
|
|
27
|
-
|
|
28
|
-
export interface OfKind<Kind extends EchoSchema.EntityKind> {
|
|
29
|
-
readonly id: Keys.ObjectId;
|
|
30
|
-
readonly [KindId]: Kind;
|
|
31
|
-
}
|
|
20
|
+
export const RuntimeType = internal.EchoSchema;
|
|
32
21
|
|
|
33
22
|
/**
|
|
34
|
-
*
|
|
23
|
+
* Dynamic type that can be constructed, mutated, and persisted in the ECHO database.
|
|
35
24
|
*/
|
|
36
|
-
export type
|
|
25
|
+
export type RuntimeType = internal.EchoSchema;
|
|
26
|
+
|
|
27
|
+
//
|
|
28
|
+
// Internal types (not exported)
|
|
29
|
+
//
|
|
37
30
|
|
|
38
31
|
/**
|
|
39
|
-
*
|
|
32
|
+
* Type that marks a schema as an ECHO schema.
|
|
33
|
+
* The value indicates the entity kind (Object or Relation).
|
|
40
34
|
*/
|
|
41
|
-
|
|
35
|
+
type EchoSchemaKind<K extends internal.EntityKind = internal.EntityKind> = {
|
|
36
|
+
readonly [internal.SchemaKindId]: K;
|
|
37
|
+
};
|
|
42
38
|
|
|
43
39
|
//
|
|
44
|
-
// Obj
|
|
40
|
+
// Obj - Runtime schema for any ECHO object
|
|
45
41
|
//
|
|
46
42
|
|
|
47
|
-
|
|
48
|
-
|
|
43
|
+
/**
|
|
44
|
+
* TypeScript type for an ECHO object schema.
|
|
45
|
+
* `T` is the instance type produced by the schema.
|
|
46
|
+
* `Fields` is the optional struct fields type for introspection.
|
|
47
|
+
*
|
|
48
|
+
* @example
|
|
49
|
+
* ```ts
|
|
50
|
+
* const PersonSchema: Type.Obj<Person> = Schema.Struct({
|
|
51
|
+
* name: Schema.String,
|
|
52
|
+
* }).pipe(Type.object({ typename: 'Person', version: '0.1.0' }));
|
|
53
|
+
*
|
|
54
|
+
* // Access fields for introspection:
|
|
55
|
+
* Object.keys(PersonSchema.fields); // ['name']
|
|
56
|
+
* ```
|
|
57
|
+
*/
|
|
58
|
+
export interface Obj<T, Fields extends Schema.Struct.Fields = Schema.Struct.Fields>
|
|
59
|
+
extends
|
|
60
|
+
internal.TypeMeta,
|
|
61
|
+
EchoSchemaKind<internal.EntityKind.Object>,
|
|
62
|
+
Schema.AnnotableClass<
|
|
63
|
+
Obj<T, Fields>,
|
|
64
|
+
EntityModule.OfKind<typeof EntityModule.Kind.Object> & T,
|
|
65
|
+
Schema.Simplify<ObjModule.BaseObjJson & ToMutable<T>>,
|
|
66
|
+
never
|
|
67
|
+
> {
|
|
68
|
+
/**
|
|
69
|
+
* The fields defined in the original struct schema.
|
|
70
|
+
* Allows accessing field definitions for introspection.
|
|
71
|
+
*/
|
|
72
|
+
readonly fields: Fields;
|
|
49
73
|
}
|
|
50
74
|
|
|
51
75
|
/**
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
*
|
|
55
|
-
*
|
|
76
|
+
* Structural base type for any ECHO object schema.
|
|
77
|
+
* Accepts both static schemas (created with Type.object()) and EchoSchema.
|
|
78
|
+
* NOTE: Does not include the brand symbol to avoid TS4053 declaration portability issues.
|
|
79
|
+
* Use Type.isObjectSchema() for runtime type guards.
|
|
56
80
|
*/
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
OfKind<EchoSchema.EntityKind.Object> & ToMutable<EffectSchema.Schema.Type<Self>>,
|
|
62
|
-
EffectSchema.Simplify<ObjJsonProps & ToMutable<EffectSchema.Schema.Encoded<Self>>>,
|
|
63
|
-
EffectSchema.Schema.Context<Self>
|
|
64
|
-
> {}
|
|
81
|
+
type ObjectSchemaBase = Schema.Schema.AnyNoContext & {
|
|
82
|
+
readonly typename: string;
|
|
83
|
+
readonly version: string;
|
|
84
|
+
};
|
|
65
85
|
|
|
66
86
|
/**
|
|
67
|
-
*
|
|
87
|
+
* Type that represents any ECHO object schema.
|
|
88
|
+
* Accepts both static schemas (Type.object()) and mutable schemas (EchoSchema).
|
|
68
89
|
*/
|
|
69
|
-
export
|
|
70
|
-
(opts: EchoSchema.TypeMeta): <Self extends EffectSchema.Schema.Any>(self: Self) => obj<Self>;
|
|
71
|
-
} = EchoSchema.EchoObject as any;
|
|
90
|
+
export type AnyObj = ObjectSchemaBase;
|
|
72
91
|
|
|
73
92
|
/**
|
|
74
|
-
*
|
|
93
|
+
* Factory function to create an ECHO object schema.
|
|
94
|
+
* Adds object metadata annotations to an Effect schema.
|
|
95
|
+
*
|
|
96
|
+
* @example
|
|
97
|
+
* ```ts
|
|
98
|
+
* const Person = Schema.Struct({
|
|
99
|
+
* name: Schema.String,
|
|
100
|
+
* }).pipe(Type.object({ typename: 'example.com/type/Person', version: '0.1.0' }));
|
|
101
|
+
* ```
|
|
75
102
|
*/
|
|
76
|
-
export
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
* NOTE: This is not an instance type.
|
|
80
|
-
*/
|
|
81
|
-
// TODO(dmaretskyi): If schema was covariant, we could specify props in here, like `id: ObjectId`.
|
|
82
|
-
// TODO(burdon): This erases the ECHO type info (e.g., id, typename).
|
|
83
|
-
export type Any = EffectSchema.Schema.AnyNoContext;
|
|
84
|
-
}
|
|
103
|
+
export const object: {
|
|
104
|
+
(opts: internal.TypeMeta): <Self extends Schema.Schema.Any>(self: Self) => Obj<Schema.Schema.Type<Self>>;
|
|
105
|
+
} = internal.EchoObjectSchema as any;
|
|
85
106
|
|
|
86
107
|
//
|
|
87
|
-
//
|
|
108
|
+
// PersistentType (Schema stored in database)
|
|
88
109
|
//
|
|
89
110
|
|
|
90
|
-
|
|
91
|
-
export interface Expando extends OfKind<EchoSchema.EntityKind.Object> {
|
|
92
|
-
[key: string]: any;
|
|
93
|
-
}
|
|
111
|
+
export const PersistentType: Obj<internal.PersistentSchema> = internal.PersistentSchema as any;
|
|
94
112
|
|
|
95
|
-
|
|
113
|
+
export interface PersistentType extends Schema.Schema.Type<typeof PersistentType> {}
|
|
96
114
|
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
interface
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
115
|
+
/**
|
|
116
|
+
* TypeScript type for an ECHO relation schema.
|
|
117
|
+
* `T` is the instance type produced by the schema (excluding source/target).
|
|
118
|
+
* `Source` and `Target` are the endpoint types.
|
|
119
|
+
* `Fields` is the optional struct fields type for introspection.
|
|
120
|
+
*/
|
|
121
|
+
export interface Relation<T, Source, Target, Fields extends Schema.Struct.Fields = Schema.Struct.Fields>
|
|
122
|
+
extends
|
|
123
|
+
internal.TypeMeta,
|
|
124
|
+
EchoSchemaKind<internal.EntityKind.Relation>,
|
|
125
|
+
Schema.AnnotableClass<
|
|
126
|
+
Relation<T, Source, Target, Fields>,
|
|
127
|
+
EntityModule.OfKind<typeof EntityModule.Kind.Relation> & RelationModule.Endpoints<Source, Target> & T,
|
|
128
|
+
Schema.Simplify<RelationModule.BaseRelationJson & ToMutable<T>>,
|
|
129
|
+
never
|
|
130
|
+
> {
|
|
131
|
+
/**
|
|
132
|
+
* The fields defined in the original struct schema.
|
|
133
|
+
* Allows accessing field definitions for introspection.
|
|
134
|
+
*/
|
|
135
|
+
readonly fields: Fields;
|
|
107
136
|
}
|
|
108
137
|
|
|
109
138
|
/**
|
|
110
|
-
*
|
|
111
|
-
*
|
|
112
|
-
*
|
|
113
|
-
*
|
|
139
|
+
* Structural base type for any ECHO relation schema.
|
|
140
|
+
* Accepts static schemas (created with Type.relation()).
|
|
141
|
+
* NOTE: Does not include the brand symbol to avoid TS4053 declaration portability issues.
|
|
142
|
+
* Use Type.isRelationSchema() for runtime type guards.
|
|
114
143
|
*/
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
> extends EchoSchema.TypeMeta,
|
|
120
|
-
EffectSchema.AnnotableClass<
|
|
121
|
-
relation<Self, SourceSchema, TargetSchema>,
|
|
122
|
-
OfKind<EchoSchema.EntityKind.Relation> &
|
|
123
|
-
Relation.Endpoints<EffectSchema.Schema.Type<SourceSchema>, EffectSchema.Schema.Type<TargetSchema>> &
|
|
124
|
-
ToMutable<EffectSchema.Schema.Type<Self>>,
|
|
125
|
-
EffectSchema.Simplify<RelationJsonProps & ToMutable<EffectSchema.Schema.Encoded<Self>>>,
|
|
126
|
-
EffectSchema.Schema.Context<Self>
|
|
127
|
-
> {}
|
|
144
|
+
type RelationSchemaBase = Schema.Schema.AnyNoContext & {
|
|
145
|
+
readonly typename: string;
|
|
146
|
+
readonly version: string;
|
|
147
|
+
};
|
|
128
148
|
|
|
129
149
|
/**
|
|
130
|
-
*
|
|
150
|
+
* Type that represents any ECHO relation schema.
|
|
151
|
+
* Accepts static schemas (Type.relation()).
|
|
131
152
|
*/
|
|
132
|
-
|
|
133
|
-
export const Relation: {
|
|
134
|
-
<Source extends EffectSchema.Schema.AnyNoContext, Target extends EffectSchema.Schema.AnyNoContext>(
|
|
135
|
-
opts: EchoSchema.EchoRelationOptions<Source, Target>,
|
|
136
|
-
): <Self extends EffectSchema.Schema.Any>(self: Self) => relation<Self, Source, Target>;
|
|
137
|
-
} = EchoSchema.EchoRelation as any;
|
|
153
|
+
export type AnyRelation = RelationSchemaBase;
|
|
138
154
|
|
|
139
155
|
/**
|
|
140
|
-
*
|
|
156
|
+
* Factory function to create an ECHO relation schema.
|
|
157
|
+
* Adds relation metadata annotations to an Effect schema.
|
|
158
|
+
*
|
|
159
|
+
* @example
|
|
160
|
+
* ```ts
|
|
161
|
+
* const WorksFor = Schema.Struct({
|
|
162
|
+
* role: Schema.String,
|
|
163
|
+
* }).pipe(Type.relation({
|
|
164
|
+
* typename: 'example.com/type/WorksFor',
|
|
165
|
+
* version: '0.1.0',
|
|
166
|
+
* source: Person,
|
|
167
|
+
* target: Company,
|
|
168
|
+
* }));
|
|
169
|
+
* ```
|
|
141
170
|
*/
|
|
142
|
-
export
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
171
|
+
export const relation: {
|
|
172
|
+
<SourceSchema extends Schema.Schema.AnyNoContext, TargetSchema extends Schema.Schema.AnyNoContext>(
|
|
173
|
+
opts: internal.EchoRelationSchemaOptions<SourceSchema, TargetSchema>,
|
|
174
|
+
): <Self extends Schema.Schema.Any>(
|
|
175
|
+
self: Self,
|
|
176
|
+
) => Relation<Schema.Schema.Type<Self>, Schema.Schema.Type<SourceSchema>, Schema.Schema.Type<TargetSchema>>;
|
|
177
|
+
} = internal.EchoRelationSchema as any;
|
|
149
178
|
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
/**
|
|
156
|
-
* Get relation target type.
|
|
157
|
-
*/
|
|
158
|
-
export type Target<A> = A extends Relation.Endpoints<infer _S, infer T> ? T : never;
|
|
159
|
-
|
|
160
|
-
export type Endpoints<Source, Target> = {
|
|
161
|
-
[RelationModule.Source]: Source;
|
|
162
|
-
[RelationModule.Target]: Target;
|
|
163
|
-
};
|
|
164
|
-
}
|
|
165
|
-
|
|
166
|
-
//
|
|
167
|
-
// Ref
|
|
168
|
-
//
|
|
179
|
+
/**
|
|
180
|
+
* Type alias for any ECHO entity schema (object or relation).
|
|
181
|
+
* Use this in type annotations for schema parameters.
|
|
182
|
+
*/
|
|
183
|
+
export type AnyEntity = AnyObj | AnyRelation;
|
|
169
184
|
|
|
170
185
|
/**
|
|
171
|
-
*
|
|
172
|
-
*
|
|
173
|
-
* This typedef avoids `TS4023` error (name from external module cannot be used named).
|
|
174
|
-
* See Effect's note on interface types.
|
|
186
|
+
* Type guard to check if a schema is an object schema.
|
|
187
|
+
* NOTE: This checks SCHEMAS, not instances. Use Obj.isObject for instances.
|
|
175
188
|
*/
|
|
176
|
-
export
|
|
177
|
-
|
|
189
|
+
export const isObjectSchema = (schema: AnyEntity): schema is AnyObj => {
|
|
190
|
+
return (schema as any)[internal.SchemaKindId] === internal.EntityKind.Object;
|
|
191
|
+
};
|
|
178
192
|
|
|
179
193
|
/**
|
|
180
|
-
*
|
|
194
|
+
* Type guard to check if a schema is a relation schema.
|
|
195
|
+
* NOTE: This checks SCHEMAS, not instances. Use Relation.isRelation for instances.
|
|
181
196
|
*/
|
|
182
|
-
export const
|
|
197
|
+
export const isRelationSchema = (schema: AnyEntity): schema is AnyRelation => {
|
|
198
|
+
return (schema as any)[internal.SchemaKindId] === internal.EntityKind.Relation;
|
|
199
|
+
};
|
|
183
200
|
|
|
184
|
-
|
|
201
|
+
/**
|
|
202
|
+
* Type that represents any Ref schema (with unknown target type).
|
|
203
|
+
* This is a schema type, not an instance type.
|
|
204
|
+
*/
|
|
205
|
+
export type AnyRef = Schema.Schema<internal.Ref<any>, EncodedReference>;
|
|
185
206
|
|
|
186
|
-
//
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
* Type that represents an arbitrary schema type of a reference.
|
|
190
|
-
* NOTE: This is not an instance type.
|
|
191
|
-
*/
|
|
192
|
-
export type Any = EffectSchema.Schema<EchoSchema.Ref<any>, EncodedReference>;
|
|
193
|
-
}
|
|
207
|
+
//
|
|
208
|
+
// Schema utility functions
|
|
209
|
+
//
|
|
194
210
|
|
|
195
211
|
/**
|
|
196
212
|
* Gets the full DXN of the schema.
|
|
@@ -198,16 +214,16 @@ export namespace Ref {
|
|
|
198
214
|
* @example "dxn:example.com/type/Person:0.1.0"
|
|
199
215
|
* @example "dxn:echo:SSSSSSSSSS:XXXXXXXXXXXXX"
|
|
200
216
|
*/
|
|
201
|
-
export const getDXN = (schema:
|
|
202
|
-
return
|
|
217
|
+
export const getDXN = (schema: AnyEntity): DXN | undefined => {
|
|
218
|
+
return internal.getSchemaDXN(schema);
|
|
203
219
|
};
|
|
204
220
|
|
|
205
221
|
/**
|
|
206
222
|
* @param schema - Schema to get the typename from.
|
|
207
223
|
* @returns The typename of the schema. Example: `example.com/type/Person`.
|
|
208
224
|
*/
|
|
209
|
-
export const getTypename = (schema:
|
|
210
|
-
const typename =
|
|
225
|
+
export const getTypename = (schema: AnyEntity): string => {
|
|
226
|
+
const typename = internal.getSchemaTypename(schema);
|
|
211
227
|
invariant(typeof typename === 'string' && !typename.startsWith('dxn:'), 'Invalid typename');
|
|
212
228
|
return typename;
|
|
213
229
|
};
|
|
@@ -216,8 +232,8 @@ export const getTypename = (schema: Obj.Any | Relation.Any): string => {
|
|
|
216
232
|
* Gets the version of the schema.
|
|
217
233
|
* @example 0.1.0
|
|
218
234
|
*/
|
|
219
|
-
export const getVersion = (schema:
|
|
220
|
-
const version =
|
|
235
|
+
export const getVersion = (schema: AnyEntity): string => {
|
|
236
|
+
const version = internal.getSchemaVersion(schema);
|
|
221
237
|
invariant(typeof version === 'string' && version.match(/^\d+\.\d+\.\d+$/), 'Invalid version');
|
|
222
238
|
return version;
|
|
223
239
|
};
|
|
@@ -225,21 +241,16 @@ export const getVersion = (schema: Obj.Any | Relation.Any): string => {
|
|
|
225
241
|
/**
|
|
226
242
|
* @returns True if the schema is mutable.
|
|
227
243
|
*/
|
|
228
|
-
export const isMutable =
|
|
244
|
+
export const isMutable = internal.isMutable;
|
|
229
245
|
|
|
230
246
|
/**
|
|
231
247
|
* ECHO type metadata.
|
|
232
248
|
*/
|
|
233
|
-
export type Meta =
|
|
249
|
+
export type Meta = internal.TypeAnnotation;
|
|
234
250
|
|
|
235
251
|
/**
|
|
236
252
|
* Gets the meta data of the schema.
|
|
237
253
|
*/
|
|
238
|
-
export const getMeta = (schema:
|
|
239
|
-
return
|
|
254
|
+
export const getMeta = (schema: AnyEntity): Meta | undefined => {
|
|
255
|
+
return internal.getTypeAnnotation(schema);
|
|
240
256
|
};
|
|
241
|
-
|
|
242
|
-
// TODO(dmaretskyi): Remove re-exports.
|
|
243
|
-
export { SpaceId, ObjectId, DXN } from '@dxos/keys';
|
|
244
|
-
|
|
245
|
-
export { Format, JsonSchemaType as JsonSchema, toEffectSchema, toJsonSchema } from './internal';
|
package/src/View.ts
ADDED
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
//
|
|
2
|
+
// Copyright 2025 DXOS.org
|
|
3
|
+
//
|
|
4
|
+
|
|
5
|
+
import * as Schema from 'effect/Schema';
|
|
6
|
+
|
|
7
|
+
import { QueryAST } from '@dxos/echo-protocol';
|
|
8
|
+
import { JsonPath } from '@dxos/effect';
|
|
9
|
+
import { PublicKey } from '@dxos/keys';
|
|
10
|
+
|
|
11
|
+
import * as Filter from './Filter';
|
|
12
|
+
import * as internal from './internal';
|
|
13
|
+
import * as Obj from './Obj';
|
|
14
|
+
import * as Query from './Query';
|
|
15
|
+
import * as Type from './Type';
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* Stored field metadata (e.g., for UX).
|
|
19
|
+
*/
|
|
20
|
+
export const FieldSchema = Schema.Struct({
|
|
21
|
+
id: Schema.String,
|
|
22
|
+
path: JsonPath,
|
|
23
|
+
visible: Schema.optional(Schema.Boolean),
|
|
24
|
+
|
|
25
|
+
// TODO(wittjosiah): Presentation-specific?
|
|
26
|
+
referencePath: Schema.optional(JsonPath),
|
|
27
|
+
});
|
|
28
|
+
|
|
29
|
+
export type FieldType = Schema.Schema.Type<typeof FieldSchema>;
|
|
30
|
+
|
|
31
|
+
export const KeyValueProps = Schema.Record({ key: Schema.String, value: Schema.Any });
|
|
32
|
+
|
|
33
|
+
export const createFieldId = () => PublicKey.random().truncate();
|
|
34
|
+
|
|
35
|
+
export const Projection = Schema.Struct({
|
|
36
|
+
/**
|
|
37
|
+
* Optional schema override used to customize the underlying schema.
|
|
38
|
+
*/
|
|
39
|
+
schema: internal.JsonSchemaType.pipe(Schema.optional),
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* UX metadata associated with displayed fields (in table, form, etc.)
|
|
43
|
+
*/
|
|
44
|
+
// TODO(wittjosiah): Should this just be an array of JsonPath?
|
|
45
|
+
fields: Schema.Array(FieldSchema),
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* The id for the field used to pivot the view.
|
|
49
|
+
* E.g., the field to use for kanban columns or the field to use for map coordinates.
|
|
50
|
+
*/
|
|
51
|
+
pivotFieldId: Schema.String.pipe(Schema.optional),
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
export type Projection = Schema.Schema.Type<typeof Projection>;
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* Views are generated or user-defined projections of a schema's properties.
|
|
58
|
+
* They are used to configure the visual representation of the data.
|
|
59
|
+
*/
|
|
60
|
+
const ViewSchema = Schema.Struct({
|
|
61
|
+
/**
|
|
62
|
+
* Query used to retrieve data.
|
|
63
|
+
* Can be a user-provided query grammar string or a query AST.
|
|
64
|
+
*/
|
|
65
|
+
query: Schema.Struct({
|
|
66
|
+
raw: Schema.optional(Schema.String),
|
|
67
|
+
ast: QueryAST.Query,
|
|
68
|
+
}),
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* Projection of the data returned from the query.
|
|
72
|
+
*/
|
|
73
|
+
projection: Projection,
|
|
74
|
+
}).pipe(
|
|
75
|
+
Type.object({
|
|
76
|
+
typename: 'dxos.org/type/View',
|
|
77
|
+
version: '0.5.0',
|
|
78
|
+
}),
|
|
79
|
+
internal.SystemTypeAnnotation.set(true),
|
|
80
|
+
);
|
|
81
|
+
|
|
82
|
+
export interface View extends Schema.Schema.Type<typeof ViewSchema> {}
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* View instance type.
|
|
86
|
+
*/
|
|
87
|
+
// NOTE: This interface is explicitly defined rather than derived from the schema to avoid
|
|
88
|
+
// TypeScript "cannot be named" portability errors. The schema contains QueryAST.Query which
|
|
89
|
+
// references internal @dxos/echo-protocol module paths. Without this explicit interface,
|
|
90
|
+
// any schema using Ref.Ref(View) would inherit the non-portable type and fail to compile.
|
|
91
|
+
// TODO(wittjosiah): Find a better solution that doesn't require manually keeping the interface in sync.
|
|
92
|
+
export const View: Type.Obj<View> = ViewSchema as any;
|
|
93
|
+
|
|
94
|
+
export const make = (props: Partial<Obj.MakeProps<typeof View>>): View => {
|
|
95
|
+
return Obj.make(View, {
|
|
96
|
+
query: { ast: Query.select(Filter.nothing()).ast },
|
|
97
|
+
projection: { fields: [] },
|
|
98
|
+
...props,
|
|
99
|
+
});
|
|
100
|
+
};
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
//
|
|
2
|
+
// Copyright 2025 DXOS.org
|
|
3
|
+
//
|
|
4
|
+
|
|
5
|
+
import { describe, expect, test } from 'vitest';
|
|
6
|
+
|
|
7
|
+
import * as Obj from './Obj';
|
|
8
|
+
import { TestSchema } from './testing';
|
|
9
|
+
|
|
10
|
+
describe('Hierarchy', () => {
|
|
11
|
+
test('setParent and getParent', async () => {
|
|
12
|
+
const parent = Obj.make(TestSchema.Organization, { name: 'parent' });
|
|
13
|
+
const child = Obj.make(TestSchema.Person, { name: 'child' });
|
|
14
|
+
expect(Obj.getParent(child)).toBeUndefined();
|
|
15
|
+
|
|
16
|
+
Obj.setParent(child, parent);
|
|
17
|
+
expect(Obj.getParent(child)).toBe(parent);
|
|
18
|
+
|
|
19
|
+
Obj.setParent(child, undefined);
|
|
20
|
+
expect(Obj.getParent(child)).toBeUndefined();
|
|
21
|
+
});
|
|
22
|
+
|
|
23
|
+
test('create object with Obj.Parent in props', () => {
|
|
24
|
+
const parent = Obj.make(TestSchema.Organization, { name: 'DXOS' });
|
|
25
|
+
const child = Obj.make(TestSchema.Person, {
|
|
26
|
+
[Obj.Parent]: parent,
|
|
27
|
+
name: 'John',
|
|
28
|
+
});
|
|
29
|
+
|
|
30
|
+
expect(child.name).toBe('John');
|
|
31
|
+
expect(Obj.getParent(child)).toBe(parent);
|
|
32
|
+
});
|
|
33
|
+
});
|
package/src/index.ts
CHANGED
|
@@ -2,15 +2,29 @@
|
|
|
2
2
|
// Copyright 2025 DXOS.org
|
|
3
3
|
//
|
|
4
4
|
|
|
5
|
-
export
|
|
6
|
-
|
|
5
|
+
export { QueryAST } from '@dxos/echo-protocol';
|
|
6
|
+
// TODO(wittjosiah): Refactor DXN to not use statics similar to Query.
|
|
7
|
+
export { DXN } from '@dxos/keys';
|
|
7
8
|
|
|
9
|
+
export * as Annotation from './Annotation';
|
|
10
|
+
export * as Database from './Database';
|
|
11
|
+
export * as Entity from './Entity';
|
|
12
|
+
export * as Err from './Err';
|
|
13
|
+
export * as Feed from './Feed';
|
|
14
|
+
export * as Filter from './Filter';
|
|
15
|
+
export * as Format from './Format';
|
|
16
|
+
export * as Hypergraph from './Hypergraph';
|
|
17
|
+
export * as JsonSchema from './JsonSchema';
|
|
8
18
|
export * as Key from './Key';
|
|
9
19
|
export * as Obj from './Obj';
|
|
20
|
+
export * as Order from './Order';
|
|
21
|
+
export * as Query from './Query';
|
|
22
|
+
export * as QueryResult from './QueryResult';
|
|
10
23
|
export * as Ref from './Ref';
|
|
11
24
|
export * as Relation from './Relation';
|
|
25
|
+
export * as SchemaRegistry from './SchemaRegistry';
|
|
26
|
+
export * as Tag from './Tag';
|
|
12
27
|
export * as Type from './Type';
|
|
13
|
-
|
|
14
|
-
export
|
|
15
|
-
export
|
|
16
|
-
export { type Live } from '@dxos/live-object';
|
|
28
|
+
export * as Collection from './Collection';
|
|
29
|
+
export * as View from './View';
|
|
30
|
+
export * as Dataset from './Dataset';
|