peerpigeon 1.1.3 → 1.2.1
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/dist/index.cjs +9011 -0
- package/dist/index.d.cts +2027 -0
- package/dist/index.d.ts +2027 -0
- package/dist/index.js +8944 -0
- package/package.json +53 -86
- package/LICENSE +0 -21
- package/README.md +0 -317
- package/cli.js +0 -1382
- package/dist/peerpigeon-browser.js +0 -13322
- package/dist/peerpigeon-browser.js.map +0 -7
- package/docs/API_DOCUMENTATION.md +0 -1976
- package/docs/BINARY_IMPLEMENTATION_SUMMARY.md +0 -304
- package/docs/BINARY_MESSAGES.md +0 -332
- package/docs/BOOTSTRAP_HUBS.md +0 -319
- package/docs/BROADCAST_STREAMING.md +0 -388
- package/docs/CLI_README.md +0 -371
- package/docs/CLOUD_DEPLOYMENT.md +0 -132
- package/docs/CUSTOM_HUB_NAMESPACES.md +0 -182
- package/docs/CUSTOM_NAMESPACE_IMPLEMENTATION.md +0 -187
- package/docs/DOCUMENTATION_REORGANIZATION.md +0 -172
- package/docs/HUB_P2P_MESH.md +0 -358
- package/docs/HUB_QUICK_REF.md +0 -108
- package/docs/HUB_SCRIPTS.md +0 -341
- package/docs/HUB_SYSTEM.md +0 -599
- package/docs/LOCAL_TESTING.md +0 -135
- package/docs/MIGRATION_COMPLETE.md +0 -93
- package/docs/NETWORK_NAMESPACES.md +0 -212
- package/docs/PIGEONRTC_MIGRATION.md +0 -280
- package/docs/README.md +0 -108
- package/docs/SELECTIVE_STREAMING_GUIDE.md +0 -427
- package/docs/STREAMING_API.md +0 -542
- package/docs/STREAMING_IMPLEMENTATION_SUMMARY.md +0 -286
- package/docs/TEST_CLEANUP_COMPLETE.md +0 -80
- package/examples/binary-message-demo.html +0 -496
- package/examples/bootstrap-hub-example.js +0 -292
- package/examples/broadcast-stream-demo.html +0 -539
- package/examples/browser/vanilla/README.md +0 -278
- package/examples/browser/vanilla/app.js +0 -2478
- package/examples/browser/vanilla/index.html +0 -603
- package/examples/browser/vanilla/minimal/README.md +0 -55
- package/examples/browser/vanilla/minimal/index.html +0 -75
- package/examples/browser/vanilla/minimal/minimal.js +0 -234
- package/examples/browser/vanilla/peerpigeon-browser.js +0 -13322
- package/examples/browser/vanilla/pigeonlogo.svg +0 -51
- package/examples/browser/vanilla/styles.css +0 -998
- package/examples/browser/vanilla/test-bundle.html +0 -35
- package/examples/browser/vue/EXPRESS_SOLUTION.md +0 -183
- package/examples/browser/vue/ICE_DEBUG.md +0 -171
- package/examples/browser/vue/IMPLEMENTATION.md +0 -218
- package/examples/browser/vue/QUICK_START.md +0 -149
- package/examples/browser/vue/README.md +0 -303
- package/examples/browser/vue/dist/assets/index-DP2m6I_g.js +0 -57
- package/examples/browser/vue/dist/assets/index-zmUJURg4.css +0 -1
- package/examples/browser/vue/dist/index.html +0 -32
- package/examples/browser/vue/dist/peerpigeon-browser.js +0 -13322
- package/examples/browser/vue/dist/pigeonlogo.svg +0 -51
- package/examples/browser/vue/index.html +0 -31
- package/examples/browser/vue/node_modules/.package-lock.json +0 -1305
- package/examples/browser/vue/node_modules/.vue-global-types/vue_99_0.d.ts +0 -136
- package/examples/browser/vue/node_modules/@babel/helper-string-parser/LICENSE +0 -22
- package/examples/browser/vue/node_modules/@babel/helper-string-parser/README.md +0 -19
- package/examples/browser/vue/node_modules/@babel/helper-string-parser/lib/index.js +0 -295
- package/examples/browser/vue/node_modules/@babel/helper-string-parser/lib/index.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/helper-string-parser/package.json +0 -31
- package/examples/browser/vue/node_modules/@babel/helper-validator-identifier/LICENSE +0 -22
- package/examples/browser/vue/node_modules/@babel/helper-validator-identifier/README.md +0 -19
- package/examples/browser/vue/node_modules/@babel/helper-validator-identifier/lib/identifier.js +0 -70
- package/examples/browser/vue/node_modules/@babel/helper-validator-identifier/lib/identifier.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/helper-validator-identifier/lib/index.js +0 -57
- package/examples/browser/vue/node_modules/@babel/helper-validator-identifier/lib/index.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/helper-validator-identifier/lib/keyword.js +0 -35
- package/examples/browser/vue/node_modules/@babel/helper-validator-identifier/lib/keyword.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/helper-validator-identifier/package.json +0 -31
- package/examples/browser/vue/node_modules/@babel/parser/CHANGELOG.md +0 -1073
- package/examples/browser/vue/node_modules/@babel/parser/LICENSE +0 -19
- package/examples/browser/vue/node_modules/@babel/parser/README.md +0 -19
- package/examples/browser/vue/node_modules/@babel/parser/bin/babel-parser.js +0 -15
- package/examples/browser/vue/node_modules/@babel/parser/lib/index.js +0 -14595
- package/examples/browser/vue/node_modules/@babel/parser/lib/index.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/parser/package.json +0 -50
- package/examples/browser/vue/node_modules/@babel/parser/typings/babel-parser.d.ts +0 -239
- package/examples/browser/vue/node_modules/@babel/types/LICENSE +0 -22
- package/examples/browser/vue/node_modules/@babel/types/README.md +0 -19
- package/examples/browser/vue/node_modules/@babel/types/lib/asserts/assertNode.js +0 -16
- package/examples/browser/vue/node_modules/@babel/types/lib/asserts/assertNode.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/asserts/generated/index.js +0 -1251
- package/examples/browser/vue/node_modules/@babel/types/lib/asserts/generated/index.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/ast-types/generated/index.js +0 -3
- package/examples/browser/vue/node_modules/@babel/types/lib/ast-types/generated/index.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/flow/createFlowUnionType.js +0 -18
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/flow/createFlowUnionType.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/flow/createTypeAnnotationBasedOnTypeof.js +0 -31
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/flow/createTypeAnnotationBasedOnTypeof.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/generated/index.js +0 -29
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/generated/index.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/generated/lowercase.js +0 -2896
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/generated/lowercase.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/generated/uppercase.js +0 -274
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/generated/uppercase.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/productions.js +0 -12
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/productions.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/react/buildChildren.js +0 -24
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/react/buildChildren.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/typescript/createTSUnionType.js +0 -22
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/typescript/createTSUnionType.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/validateNode.js +0 -21
- package/examples/browser/vue/node_modules/@babel/types/lib/builders/validateNode.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/clone/clone.js +0 -12
- package/examples/browser/vue/node_modules/@babel/types/lib/clone/clone.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/clone/cloneDeep.js +0 -12
- package/examples/browser/vue/node_modules/@babel/types/lib/clone/cloneDeep.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/clone/cloneDeepWithoutLoc.js +0 -12
- package/examples/browser/vue/node_modules/@babel/types/lib/clone/cloneDeepWithoutLoc.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/clone/cloneNode.js +0 -107
- package/examples/browser/vue/node_modules/@babel/types/lib/clone/cloneNode.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/clone/cloneWithoutLoc.js +0 -12
- package/examples/browser/vue/node_modules/@babel/types/lib/clone/cloneWithoutLoc.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/addComment.js +0 -15
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/addComment.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/addComments.js +0 -22
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/addComments.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/inheritInnerComments.js +0 -12
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/inheritInnerComments.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/inheritLeadingComments.js +0 -12
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/inheritLeadingComments.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/inheritTrailingComments.js +0 -12
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/inheritTrailingComments.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/inheritsComments.js +0 -17
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/inheritsComments.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/removeComments.js +0 -15
- package/examples/browser/vue/node_modules/@babel/types/lib/comments/removeComments.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/constants/generated/index.js +0 -60
- package/examples/browser/vue/node_modules/@babel/types/lib/constants/generated/index.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/constants/index.js +0 -33
- package/examples/browser/vue/node_modules/@babel/types/lib/constants/index.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/ensureBlock.js +0 -14
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/ensureBlock.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/gatherSequenceExpressions.js +0 -66
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/gatherSequenceExpressions.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toBindingIdentifierName.js +0 -14
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toBindingIdentifierName.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toBlock.js +0 -29
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toBlock.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toComputedKey.js +0 -14
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toComputedKey.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toExpression.js +0 -28
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toExpression.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toIdentifier.js +0 -25
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toIdentifier.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toKeyAlias.js +0 -38
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toKeyAlias.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toSequenceExpression.js +0 -20
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toSequenceExpression.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toStatement.js +0 -39
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/toStatement.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/valueToNode.js +0 -89
- package/examples/browser/vue/node_modules/@babel/types/lib/converters/valueToNode.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/core.js +0 -1659
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/core.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/deprecated-aliases.js +0 -11
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/deprecated-aliases.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/experimental.js +0 -126
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/experimental.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/flow.js +0 -495
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/flow.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/index.js +0 -100
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/index.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/jsx.js +0 -157
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/jsx.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/misc.js +0 -33
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/misc.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/placeholders.js +0 -27
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/placeholders.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/typescript.js +0 -528
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/typescript.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/utils.js +0 -292
- package/examples/browser/vue/node_modules/@babel/types/lib/definitions/utils.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/index-legacy.d.ts +0 -2797
- package/examples/browser/vue/node_modules/@babel/types/lib/index.d.ts +0 -3308
- package/examples/browser/vue/node_modules/@babel/types/lib/index.js +0 -584
- package/examples/browser/vue/node_modules/@babel/types/lib/index.js.flow +0 -2650
- package/examples/browser/vue/node_modules/@babel/types/lib/index.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/appendToMemberExpression.js +0 -15
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/appendToMemberExpression.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/flow/removeTypeDuplicates.js +0 -65
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/flow/removeTypeDuplicates.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/inherits.js +0 -28
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/inherits.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/prependToMemberExpression.js +0 -17
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/prependToMemberExpression.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/removeProperties.js +0 -24
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/removeProperties.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/removePropertiesDeep.js +0 -14
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/removePropertiesDeep.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/typescript/removeTypeDuplicates.js +0 -66
- package/examples/browser/vue/node_modules/@babel/types/lib/modifications/typescript/removeTypeDuplicates.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/retrievers/getAssignmentIdentifiers.js +0 -48
- package/examples/browser/vue/node_modules/@babel/types/lib/retrievers/getAssignmentIdentifiers.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/retrievers/getBindingIdentifiers.js +0 -102
- package/examples/browser/vue/node_modules/@babel/types/lib/retrievers/getBindingIdentifiers.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/retrievers/getFunctionName.js +0 -63
- package/examples/browser/vue/node_modules/@babel/types/lib/retrievers/getFunctionName.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/retrievers/getOuterBindingIdentifiers.js +0 -13
- package/examples/browser/vue/node_modules/@babel/types/lib/retrievers/getOuterBindingIdentifiers.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/traverse/traverse.js +0 -50
- package/examples/browser/vue/node_modules/@babel/types/lib/traverse/traverse.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/traverse/traverseFast.js +0 -40
- package/examples/browser/vue/node_modules/@babel/types/lib/traverse/traverseFast.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/utils/deprecationWarning.js +0 -44
- package/examples/browser/vue/node_modules/@babel/types/lib/utils/deprecationWarning.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/utils/inherit.js +0 -13
- package/examples/browser/vue/node_modules/@babel/types/lib/utils/inherit.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/utils/react/cleanJSXElementLiteralChild.js +0 -40
- package/examples/browser/vue/node_modules/@babel/types/lib/utils/react/cleanJSXElementLiteralChild.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/utils/shallowEqual.js +0 -17
- package/examples/browser/vue/node_modules/@babel/types/lib/utils/shallowEqual.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/buildMatchMemberExpression.js +0 -13
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/buildMatchMemberExpression.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/generated/index.js +0 -2797
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/generated/index.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/is.js +0 -27
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/is.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isBinding.js +0 -27
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isBinding.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isBlockScoped.js +0 -13
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isBlockScoped.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isImmutable.js +0 -21
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isImmutable.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isLet.js +0 -17
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isLet.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isNode.js +0 -12
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isNode.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isNodesEquivalent.js +0 -57
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isNodesEquivalent.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isPlaceholderType.js +0 -15
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isPlaceholderType.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isReferenced.js +0 -96
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isReferenced.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isScope.js +0 -18
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isScope.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isSpecifierDefault.js +0 -14
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isSpecifierDefault.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isType.js +0 -17
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isType.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isValidES3Identifier.js +0 -13
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isValidES3Identifier.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isValidIdentifier.js +0 -18
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isValidIdentifier.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isVar.js +0 -19
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/isVar.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/matchesPattern.js +0 -44
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/matchesPattern.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/react/isCompatTag.js +0 -11
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/react/isCompatTag.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/react/isReactComponent.js +0 -11
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/react/isReactComponent.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/validate.js +0 -42
- package/examples/browser/vue/node_modules/@babel/types/lib/validators/validate.js.map +0 -1
- package/examples/browser/vue/node_modules/@babel/types/package.json +0 -39
- package/examples/browser/vue/node_modules/@esbuild/darwin-arm64/README.md +0 -3
- package/examples/browser/vue/node_modules/@esbuild/darwin-arm64/bin/esbuild +0 -0
- package/examples/browser/vue/node_modules/@esbuild/darwin-arm64/package.json +0 -20
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/LICENSE +0 -19
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/README.md +0 -264
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.mjs +0 -423
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.mjs.map +0 -6
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.umd.js +0 -464
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.umd.js.map +0 -6
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/package.json +0 -63
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/src/scopes.ts +0 -345
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/src/sourcemap-codec.ts +0 -111
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/src/strings.ts +0 -65
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/src/vlq.ts +0 -55
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/scopes.d.cts +0 -50
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/scopes.d.cts.map +0 -1
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/scopes.d.mts +0 -50
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/scopes.d.mts.map +0 -1
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/sourcemap-codec.d.cts +0 -9
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/sourcemap-codec.d.cts.map +0 -1
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/sourcemap-codec.d.mts +0 -9
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/sourcemap-codec.d.mts.map +0 -1
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/strings.d.cts +0 -16
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/strings.d.cts.map +0 -1
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/strings.d.mts +0 -16
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/strings.d.mts.map +0 -1
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/vlq.d.cts +0 -7
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/vlq.d.cts.map +0 -1
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/vlq.d.mts +0 -7
- package/examples/browser/vue/node_modules/@jridgewell/sourcemap-codec/types/vlq.d.mts.map +0 -1
- package/examples/browser/vue/node_modules/@rollup/rollup-darwin-arm64/README.md +0 -3
- package/examples/browser/vue/node_modules/@rollup/rollup-darwin-arm64/package.json +0 -22
- package/examples/browser/vue/node_modules/@rollup/rollup-darwin-arm64/rollup.darwin-arm64.node +0 -0
- package/examples/browser/vue/node_modules/@types/estree/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@types/estree/README.md +0 -15
- package/examples/browser/vue/node_modules/@types/estree/flow.d.ts +0 -167
- package/examples/browser/vue/node_modules/@types/estree/index.d.ts +0 -694
- package/examples/browser/vue/node_modules/@types/estree/package.json +0 -27
- package/examples/browser/vue/node_modules/@types/web-bluetooth/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@types/web-bluetooth/README.md +0 -15
- package/examples/browser/vue/node_modules/@types/web-bluetooth/index.d.ts +0 -193
- package/examples/browser/vue/node_modules/@types/web-bluetooth/package.json +0 -40
- package/examples/browser/vue/node_modules/@vitejs/plugin-vue/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vitejs/plugin-vue/README.md +0 -278
- package/examples/browser/vue/node_modules/@vitejs/plugin-vue/dist/index.cjs +0 -3105
- package/examples/browser/vue/node_modules/@vitejs/plugin-vue/dist/index.d.cts +0 -113
- package/examples/browser/vue/node_modules/@vitejs/plugin-vue/dist/index.d.mts +0 -111
- package/examples/browser/vue/node_modules/@vitejs/plugin-vue/dist/index.d.ts +0 -113
- package/examples/browser/vue/node_modules/@vitejs/plugin-vue/dist/index.mjs +0 -3090
- package/examples/browser/vue/node_modules/@vitejs/plugin-vue/package.json +0 -50
- package/examples/browser/vue/node_modules/@vue/compiler-core/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vue/compiler-core/README.md +0 -1
- package/examples/browser/vue/node_modules/@vue/compiler-core/dist/compiler-core.cjs.js +0 -6864
- package/examples/browser/vue/node_modules/@vue/compiler-core/dist/compiler-core.cjs.prod.js +0 -6741
- package/examples/browser/vue/node_modules/@vue/compiler-core/dist/compiler-core.d.ts +0 -1096
- package/examples/browser/vue/node_modules/@vue/compiler-core/dist/compiler-core.esm-bundler.js +0 -5814
- package/examples/browser/vue/node_modules/@vue/compiler-core/index.js +0 -7
- package/examples/browser/vue/node_modules/@vue/compiler-core/package.json +0 -58
- package/examples/browser/vue/node_modules/@vue/compiler-dom/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vue/compiler-dom/README.md +0 -1
- package/examples/browser/vue/node_modules/@vue/compiler-dom/dist/compiler-dom.cjs.js +0 -934
- package/examples/browser/vue/node_modules/@vue/compiler-dom/dist/compiler-dom.cjs.prod.js +0 -689
- package/examples/browser/vue/node_modules/@vue/compiler-dom/dist/compiler-dom.d.ts +0 -45
- package/examples/browser/vue/node_modules/@vue/compiler-dom/dist/compiler-dom.esm-browser.js +0 -6623
- package/examples/browser/vue/node_modules/@vue/compiler-dom/dist/compiler-dom.esm-browser.prod.js +0 -14
- package/examples/browser/vue/node_modules/@vue/compiler-dom/dist/compiler-dom.esm-bundler.js +0 -690
- package/examples/browser/vue/node_modules/@vue/compiler-dom/dist/compiler-dom.global.js +0 -6790
- package/examples/browser/vue/node_modules/@vue/compiler-dom/dist/compiler-dom.global.prod.js +0 -14
- package/examples/browser/vue/node_modules/@vue/compiler-dom/index.js +0 -7
- package/examples/browser/vue/node_modules/@vue/compiler-dom/package.json +0 -57
- package/examples/browser/vue/node_modules/@vue/compiler-sfc/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vue/compiler-sfc/README.md +0 -80
- package/examples/browser/vue/node_modules/@vue/compiler-sfc/dist/compiler-sfc.cjs.js +0 -25084
- package/examples/browser/vue/node_modules/@vue/compiler-sfc/dist/compiler-sfc.d.ts +0 -485
- package/examples/browser/vue/node_modules/@vue/compiler-sfc/dist/compiler-sfc.esm-browser.js +0 -50571
- package/examples/browser/vue/node_modules/@vue/compiler-sfc/package.json +0 -67
- package/examples/browser/vue/node_modules/@vue/compiler-ssr/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vue/compiler-ssr/README.md +0 -1
- package/examples/browser/vue/node_modules/@vue/compiler-ssr/dist/compiler-ssr.cjs.js +0 -1411
- package/examples/browser/vue/node_modules/@vue/compiler-ssr/dist/compiler-ssr.d.ts +0 -4
- package/examples/browser/vue/node_modules/@vue/compiler-ssr/package.json +0 -34
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/api/api.js +0 -2
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/api/app.js +0 -2
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/api/component.js +0 -2
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/api/context.js +0 -2
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/api/hooks.js +0 -2
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/api/index.js +0 -22
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/api/util.js +0 -2
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/const.js +0 -5
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/env.js +0 -17
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/index.js +0 -45
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/plugin.js +0 -2
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/proxy.js +0 -111
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/cjs/time.js +0 -28
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/api.d.ts +0 -108
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/api.js +0 -1
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/app.d.ts +0 -1
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/app.js +0 -1
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/component.d.ts +0 -78
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/component.js +0 -1
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/context.d.ts +0 -5
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/context.js +0 -1
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/hooks.d.ts +0 -180
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/hooks.js +0 -1
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/index.d.ts +0 -6
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/index.js +0 -6
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/util.d.ts +0 -4
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/api/util.js +0 -1
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/const.d.ts +0 -2
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/const.js +0 -2
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/env.d.ts +0 -15
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/env.js +0 -12
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/index.d.ts +0 -18
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/index.js +0 -27
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/plugin.d.ts +0 -47
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/plugin.js +0 -1
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/proxy.d.ts +0 -20
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/proxy.js +0 -107
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/time.d.ts +0 -2
- package/examples/browser/vue/node_modules/@vue/devtools-api/lib/esm/time.js +0 -23
- package/examples/browser/vue/node_modules/@vue/devtools-api/package.json +0 -37
- package/examples/browser/vue/node_modules/@vue/reactivity/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vue/reactivity/README.md +0 -19
- package/examples/browser/vue/node_modules/@vue/reactivity/dist/reactivity.cjs.js +0 -1963
- package/examples/browser/vue/node_modules/@vue/reactivity/dist/reactivity.cjs.prod.js +0 -1807
- package/examples/browser/vue/node_modules/@vue/reactivity/dist/reactivity.d.ts +0 -757
- package/examples/browser/vue/node_modules/@vue/reactivity/dist/reactivity.esm-browser.js +0 -1961
- package/examples/browser/vue/node_modules/@vue/reactivity/dist/reactivity.esm-browser.prod.js +0 -5
- package/examples/browser/vue/node_modules/@vue/reactivity/dist/reactivity.esm-bundler.js +0 -1920
- package/examples/browser/vue/node_modules/@vue/reactivity/dist/reactivity.global.js +0 -2017
- package/examples/browser/vue/node_modules/@vue/reactivity/dist/reactivity.global.prod.js +0 -5
- package/examples/browser/vue/node_modules/@vue/reactivity/index.js +0 -7
- package/examples/browser/vue/node_modules/@vue/reactivity/package.json +0 -55
- package/examples/browser/vue/node_modules/@vue/runtime-core/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vue/runtime-core/README.md +0 -28
- package/examples/browser/vue/node_modules/@vue/runtime-core/dist/runtime-core.cjs.js +0 -8586
- package/examples/browser/vue/node_modules/@vue/runtime-core/dist/runtime-core.cjs.prod.js +0 -6732
- package/examples/browser/vue/node_modules/@vue/runtime-core/dist/runtime-core.d.ts +0 -1839
- package/examples/browser/vue/node_modules/@vue/runtime-core/dist/runtime-core.esm-bundler.js +0 -8515
- package/examples/browser/vue/node_modules/@vue/runtime-core/index.js +0 -7
- package/examples/browser/vue/node_modules/@vue/runtime-core/package.json +0 -52
- package/examples/browser/vue/node_modules/@vue/runtime-dom/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vue/runtime-dom/README.md +0 -13
- package/examples/browser/vue/node_modules/@vue/runtime-dom/dist/runtime-dom.cjs.js +0 -1851
- package/examples/browser/vue/node_modules/@vue/runtime-dom/dist/runtime-dom.cjs.prod.js +0 -1703
- package/examples/browser/vue/node_modules/@vue/runtime-dom/dist/runtime-dom.d.ts +0 -1409
- package/examples/browser/vue/node_modules/@vue/runtime-dom/dist/runtime-dom.esm-browser.js +0 -12499
- package/examples/browser/vue/node_modules/@vue/runtime-dom/dist/runtime-dom.esm-browser.prod.js +0 -6
- package/examples/browser/vue/node_modules/@vue/runtime-dom/dist/runtime-dom.esm-bundler.js +0 -1892
- package/examples/browser/vue/node_modules/@vue/runtime-dom/dist/runtime-dom.global.js +0 -12550
- package/examples/browser/vue/node_modules/@vue/runtime-dom/dist/runtime-dom.global.prod.js +0 -6
- package/examples/browser/vue/node_modules/@vue/runtime-dom/index.js +0 -7
- package/examples/browser/vue/node_modules/@vue/runtime-dom/package.json +0 -60
- package/examples/browser/vue/node_modules/@vue/server-renderer/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vue/server-renderer/README.md +0 -178
- package/examples/browser/vue/node_modules/@vue/server-renderer/dist/server-renderer.cjs.js +0 -1151
- package/examples/browser/vue/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js +0 -879
- package/examples/browser/vue/node_modules/@vue/server-renderer/dist/server-renderer.d.ts +0 -65
- package/examples/browser/vue/node_modules/@vue/server-renderer/dist/server-renderer.esm-browser.js +0 -8488
- package/examples/browser/vue/node_modules/@vue/server-renderer/dist/server-renderer.esm-browser.prod.js +0 -5
- package/examples/browser/vue/node_modules/@vue/server-renderer/dist/server-renderer.esm-bundler.js +0 -1088
- package/examples/browser/vue/node_modules/@vue/server-renderer/index.js +0 -7
- package/examples/browser/vue/node_modules/@vue/server-renderer/package.json +0 -55
- package/examples/browser/vue/node_modules/@vue/shared/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vue/shared/README.md +0 -3
- package/examples/browser/vue/node_modules/@vue/shared/dist/shared.cjs.js +0 -612
- package/examples/browser/vue/node_modules/@vue/shared/dist/shared.cjs.prod.js +0 -604
- package/examples/browser/vue/node_modules/@vue/shared/dist/shared.d.ts +0 -334
- package/examples/browser/vue/node_modules/@vue/shared/dist/shared.esm-bundler.js +0 -536
- package/examples/browser/vue/node_modules/@vue/shared/index.js +0 -7
- package/examples/browser/vue/node_modules/@vue/shared/package.json +0 -47
- package/examples/browser/vue/node_modules/@vueuse/core/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vueuse/core/README.md +0 -124
- package/examples/browser/vue/node_modules/@vueuse/core/index.cjs +0 -7660
- package/examples/browser/vue/node_modules/@vueuse/core/index.d.cts +0 -5382
- package/examples/browser/vue/node_modules/@vueuse/core/index.d.mts +0 -5382
- package/examples/browser/vue/node_modules/@vueuse/core/index.d.ts +0 -5382
- package/examples/browser/vue/node_modules/@vueuse/core/index.iife.js +0 -7780
- package/examples/browser/vue/node_modules/@vueuse/core/index.iife.min.js +0 -1
- package/examples/browser/vue/node_modules/@vueuse/core/index.mjs +0 -7486
- package/examples/browser/vue/node_modules/@vueuse/core/metadata.cjs +0 -1
- package/examples/browser/vue/node_modules/@vueuse/core/metadata.d.cts +0 -1
- package/examples/browser/vue/node_modules/@vueuse/core/metadata.d.mts +0 -1
- package/examples/browser/vue/node_modules/@vueuse/core/metadata.d.ts +0 -1
- package/examples/browser/vue/node_modules/@vueuse/core/metadata.mjs +0 -1
- package/examples/browser/vue/node_modules/@vueuse/core/package.json +0 -45
- package/examples/browser/vue/node_modules/@vueuse/metadata/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vueuse/metadata/index.cjs +0 -2638
- package/examples/browser/vue/node_modules/@vueuse/metadata/index.d.cts +0 -76
- package/examples/browser/vue/node_modules/@vueuse/metadata/index.d.mts +0 -76
- package/examples/browser/vue/node_modules/@vueuse/metadata/index.d.ts +0 -76
- package/examples/browser/vue/node_modules/@vueuse/metadata/index.json +0 -2584
- package/examples/browser/vue/node_modules/@vueuse/metadata/index.mjs +0 -2626
- package/examples/browser/vue/node_modules/@vueuse/metadata/package.json +0 -39
- package/examples/browser/vue/node_modules/@vueuse/shared/LICENSE +0 -21
- package/examples/browser/vue/node_modules/@vueuse/shared/index.cjs +0 -1695
- package/examples/browser/vue/node_modules/@vueuse/shared/index.d.cts +0 -1221
- package/examples/browser/vue/node_modules/@vueuse/shared/index.d.mts +0 -1221
- package/examples/browser/vue/node_modules/@vueuse/shared/index.d.ts +0 -1221
- package/examples/browser/vue/node_modules/@vueuse/shared/index.iife.js +0 -1816
- package/examples/browser/vue/node_modules/@vueuse/shared/index.iife.min.js +0 -1
- package/examples/browser/vue/node_modules/@vueuse/shared/index.mjs +0 -1575
- package/examples/browser/vue/node_modules/@vueuse/shared/package.json +0 -37
- package/examples/browser/vue/node_modules/csstype/LICENSE +0 -19
- package/examples/browser/vue/node_modules/csstype/README.md +0 -277
- package/examples/browser/vue/node_modules/csstype/index.d.ts +0 -21297
- package/examples/browser/vue/node_modules/csstype/index.js.flow +0 -6612
- package/examples/browser/vue/node_modules/csstype/package.json +0 -66
- package/examples/browser/vue/node_modules/entities/LICENSE +0 -11
- package/examples/browser/vue/node_modules/entities/lib/decode.d.ts +0 -211
- package/examples/browser/vue/node_modules/entities/lib/decode.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/decode.js +0 -536
- package/examples/browser/vue/node_modules/entities/lib/decode.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/decode_codepoint.d.ts +0 -19
- package/examples/browser/vue/node_modules/entities/lib/decode_codepoint.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/decode_codepoint.js +0 -76
- package/examples/browser/vue/node_modules/entities/lib/decode_codepoint.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/encode.d.ts +0 -22
- package/examples/browser/vue/node_modules/entities/lib/encode.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/encode.js +0 -77
- package/examples/browser/vue/node_modules/entities/lib/encode.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/escape.d.ts +0 -43
- package/examples/browser/vue/node_modules/entities/lib/escape.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/escape.js +0 -122
- package/examples/browser/vue/node_modules/entities/lib/escape.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/decode.d.ts +0 -211
- package/examples/browser/vue/node_modules/entities/lib/esm/decode.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/decode.js +0 -496
- package/examples/browser/vue/node_modules/entities/lib/esm/decode.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/decode_codepoint.d.ts +0 -19
- package/examples/browser/vue/node_modules/entities/lib/esm/decode_codepoint.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/decode_codepoint.js +0 -71
- package/examples/browser/vue/node_modules/entities/lib/esm/decode_codepoint.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/encode.d.ts +0 -22
- package/examples/browser/vue/node_modules/entities/lib/esm/encode.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/encode.js +0 -69
- package/examples/browser/vue/node_modules/entities/lib/esm/encode.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/escape.d.ts +0 -43
- package/examples/browser/vue/node_modules/entities/lib/esm/escape.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/escape.js +0 -116
- package/examples/browser/vue/node_modules/entities/lib/esm/escape.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/decode-data-html.d.ts +0 -3
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/decode-data-html.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/decode-data-html.js +0 -7
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/decode-data-html.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/decode-data-xml.d.ts +0 -3
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/decode-data-xml.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/decode-data-xml.js +0 -7
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/decode-data-xml.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/encode-html.d.ts +0 -8
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/encode-html.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/encode-html.js +0 -10
- package/examples/browser/vue/node_modules/entities/lib/esm/generated/encode-html.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/index.d.ts +0 -96
- package/examples/browser/vue/node_modules/entities/lib/esm/index.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/index.js +0 -99
- package/examples/browser/vue/node_modules/entities/lib/esm/index.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/esm/package.json +0 -1
- package/examples/browser/vue/node_modules/entities/lib/generated/decode-data-html.d.ts +0 -3
- package/examples/browser/vue/node_modules/entities/lib/generated/decode-data-html.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/generated/decode-data-html.js +0 -9
- package/examples/browser/vue/node_modules/entities/lib/generated/decode-data-html.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/generated/decode-data-xml.d.ts +0 -3
- package/examples/browser/vue/node_modules/entities/lib/generated/decode-data-xml.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/generated/decode-data-xml.js +0 -9
- package/examples/browser/vue/node_modules/entities/lib/generated/decode-data-xml.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/generated/encode-html.d.ts +0 -8
- package/examples/browser/vue/node_modules/entities/lib/generated/encode-html.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/generated/encode-html.js +0 -12
- package/examples/browser/vue/node_modules/entities/lib/generated/encode-html.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/index.d.ts +0 -96
- package/examples/browser/vue/node_modules/entities/lib/index.d.ts.map +0 -1
- package/examples/browser/vue/node_modules/entities/lib/index.js +0 -126
- package/examples/browser/vue/node_modules/entities/lib/index.js.map +0 -1
- package/examples/browser/vue/node_modules/entities/package.json +0 -90
- package/examples/browser/vue/node_modules/entities/readme.md +0 -122
- package/examples/browser/vue/node_modules/esbuild/LICENSE.md +0 -21
- package/examples/browser/vue/node_modules/esbuild/README.md +0 -3
- package/examples/browser/vue/node_modules/esbuild/bin/esbuild +0 -0
- package/examples/browser/vue/node_modules/esbuild/install.js +0 -285
- package/examples/browser/vue/node_modules/esbuild/lib/main.d.ts +0 -705
- package/examples/browser/vue/node_modules/esbuild/lib/main.js +0 -2239
- package/examples/browser/vue/node_modules/esbuild/package.json +0 -46
- package/examples/browser/vue/node_modules/estree-walker/CHANGELOG.md +0 -92
- package/examples/browser/vue/node_modules/estree-walker/LICENSE +0 -7
- package/examples/browser/vue/node_modules/estree-walker/README.md +0 -48
- package/examples/browser/vue/node_modules/estree-walker/dist/esm/estree-walker.js +0 -333
- package/examples/browser/vue/node_modules/estree-walker/dist/esm/package.json +0 -1
- package/examples/browser/vue/node_modules/estree-walker/dist/umd/estree-walker.js +0 -344
- package/examples/browser/vue/node_modules/estree-walker/package.json +0 -37
- package/examples/browser/vue/node_modules/estree-walker/src/async.js +0 -118
- package/examples/browser/vue/node_modules/estree-walker/src/index.js +0 -35
- package/examples/browser/vue/node_modules/estree-walker/src/package.json +0 -1
- package/examples/browser/vue/node_modules/estree-walker/src/sync.js +0 -118
- package/examples/browser/vue/node_modules/estree-walker/src/walker.js +0 -61
- package/examples/browser/vue/node_modules/estree-walker/types/async.d.ts +0 -53
- package/examples/browser/vue/node_modules/estree-walker/types/index.d.ts +0 -56
- package/examples/browser/vue/node_modules/estree-walker/types/sync.d.ts +0 -53
- package/examples/browser/vue/node_modules/estree-walker/types/tsconfig.tsbuildinfo +0 -345
- package/examples/browser/vue/node_modules/estree-walker/types/walker.d.ts +0 -37
- package/examples/browser/vue/node_modules/fsevents/LICENSE +0 -22
- package/examples/browser/vue/node_modules/fsevents/README.md +0 -89
- package/examples/browser/vue/node_modules/fsevents/fsevents.d.ts +0 -46
- package/examples/browser/vue/node_modules/fsevents/fsevents.js +0 -83
- package/examples/browser/vue/node_modules/fsevents/fsevents.node +0 -0
- package/examples/browser/vue/node_modules/fsevents/package.json +0 -62
- package/examples/browser/vue/node_modules/magic-string/LICENSE +0 -7
- package/examples/browser/vue/node_modules/magic-string/README.md +0 -324
- package/examples/browser/vue/node_modules/magic-string/dist/magic-string.cjs.d.ts +0 -289
- package/examples/browser/vue/node_modules/magic-string/dist/magic-string.cjs.js +0 -1594
- package/examples/browser/vue/node_modules/magic-string/dist/magic-string.cjs.js.map +0 -1
- package/examples/browser/vue/node_modules/magic-string/dist/magic-string.es.d.mts +0 -289
- package/examples/browser/vue/node_modules/magic-string/dist/magic-string.es.mjs +0 -1588
- package/examples/browser/vue/node_modules/magic-string/dist/magic-string.es.mjs.map +0 -1
- package/examples/browser/vue/node_modules/magic-string/dist/magic-string.umd.js +0 -1682
- package/examples/browser/vue/node_modules/magic-string/dist/magic-string.umd.js.map +0 -1
- package/examples/browser/vue/node_modules/magic-string/package.json +0 -70
- package/examples/browser/vue/node_modules/nanoid/LICENSE +0 -20
- package/examples/browser/vue/node_modules/nanoid/README.md +0 -39
- package/examples/browser/vue/node_modules/nanoid/async/index.browser.cjs +0 -69
- package/examples/browser/vue/node_modules/nanoid/async/index.browser.js +0 -34
- package/examples/browser/vue/node_modules/nanoid/async/index.cjs +0 -71
- package/examples/browser/vue/node_modules/nanoid/async/index.d.ts +0 -56
- package/examples/browser/vue/node_modules/nanoid/async/index.js +0 -35
- package/examples/browser/vue/node_modules/nanoid/async/index.native.js +0 -26
- package/examples/browser/vue/node_modules/nanoid/async/package.json +0 -12
- package/examples/browser/vue/node_modules/nanoid/bin/nanoid.cjs +0 -55
- package/examples/browser/vue/node_modules/nanoid/index.browser.cjs +0 -72
- package/examples/browser/vue/node_modules/nanoid/index.browser.js +0 -34
- package/examples/browser/vue/node_modules/nanoid/index.cjs +0 -85
- package/examples/browser/vue/node_modules/nanoid/index.d.cts +0 -91
- package/examples/browser/vue/node_modules/nanoid/index.d.ts +0 -91
- package/examples/browser/vue/node_modules/nanoid/index.js +0 -45
- package/examples/browser/vue/node_modules/nanoid/nanoid.js +0 -1
- package/examples/browser/vue/node_modules/nanoid/non-secure/index.cjs +0 -34
- package/examples/browser/vue/node_modules/nanoid/non-secure/index.d.ts +0 -33
- package/examples/browser/vue/node_modules/nanoid/non-secure/index.js +0 -21
- package/examples/browser/vue/node_modules/nanoid/non-secure/package.json +0 -6
- package/examples/browser/vue/node_modules/nanoid/package.json +0 -89
- package/examples/browser/vue/node_modules/nanoid/url-alphabet/index.cjs +0 -7
- package/examples/browser/vue/node_modules/nanoid/url-alphabet/index.js +0 -3
- package/examples/browser/vue/node_modules/nanoid/url-alphabet/package.json +0 -6
- package/examples/browser/vue/node_modules/picocolors/LICENSE +0 -15
- package/examples/browser/vue/node_modules/picocolors/README.md +0 -21
- package/examples/browser/vue/node_modules/picocolors/package.json +0 -25
- package/examples/browser/vue/node_modules/picocolors/picocolors.browser.js +0 -4
- package/examples/browser/vue/node_modules/picocolors/picocolors.d.ts +0 -5
- package/examples/browser/vue/node_modules/picocolors/picocolors.js +0 -75
- package/examples/browser/vue/node_modules/picocolors/types.d.ts +0 -51
- package/examples/browser/vue/node_modules/pinia/LICENSE +0 -21
- package/examples/browser/vue/node_modules/pinia/README.md +0 -24
- package/examples/browser/vue/node_modules/pinia/dist/pinia.cjs +0 -2061
- package/examples/browser/vue/node_modules/pinia/dist/pinia.d.ts +0 -1074
- package/examples/browser/vue/node_modules/pinia/dist/pinia.esm-browser.js +0 -2036
- package/examples/browser/vue/node_modules/pinia/dist/pinia.iife.js +0 -2223
- package/examples/browser/vue/node_modules/pinia/dist/pinia.iife.prod.js +0 -7
- package/examples/browser/vue/node_modules/pinia/dist/pinia.mjs +0 -2044
- package/examples/browser/vue/node_modules/pinia/dist/pinia.prod.cjs +0 -846
- package/examples/browser/vue/node_modules/pinia/index.cjs +0 -7
- package/examples/browser/vue/node_modules/pinia/index.js +0 -7
- package/examples/browser/vue/node_modules/pinia/package.json +0 -96
- package/examples/browser/vue/node_modules/postcss/LICENSE +0 -20
- package/examples/browser/vue/node_modules/postcss/README.md +0 -29
- package/examples/browser/vue/node_modules/postcss/lib/at-rule.d.ts +0 -140
- package/examples/browser/vue/node_modules/postcss/lib/at-rule.js +0 -25
- package/examples/browser/vue/node_modules/postcss/lib/comment.d.ts +0 -68
- package/examples/browser/vue/node_modules/postcss/lib/comment.js +0 -13
- package/examples/browser/vue/node_modules/postcss/lib/container.d.ts +0 -483
- package/examples/browser/vue/node_modules/postcss/lib/container.js +0 -447
- package/examples/browser/vue/node_modules/postcss/lib/css-syntax-error.d.ts +0 -248
- package/examples/browser/vue/node_modules/postcss/lib/css-syntax-error.js +0 -133
- package/examples/browser/vue/node_modules/postcss/lib/declaration.d.ts +0 -151
- package/examples/browser/vue/node_modules/postcss/lib/declaration.js +0 -24
- package/examples/browser/vue/node_modules/postcss/lib/document.d.ts +0 -69
- package/examples/browser/vue/node_modules/postcss/lib/document.js +0 -33
- package/examples/browser/vue/node_modules/postcss/lib/fromJSON.d.ts +0 -9
- package/examples/browser/vue/node_modules/postcss/lib/fromJSON.js +0 -54
- package/examples/browser/vue/node_modules/postcss/lib/input.d.ts +0 -227
- package/examples/browser/vue/node_modules/postcss/lib/input.js +0 -265
- package/examples/browser/vue/node_modules/postcss/lib/lazy-result.d.ts +0 -190
- package/examples/browser/vue/node_modules/postcss/lib/lazy-result.js +0 -550
- package/examples/browser/vue/node_modules/postcss/lib/list.d.ts +0 -60
- package/examples/browser/vue/node_modules/postcss/lib/list.js +0 -58
- package/examples/browser/vue/node_modules/postcss/lib/map-generator.js +0 -368
- package/examples/browser/vue/node_modules/postcss/lib/no-work-result.d.ts +0 -46
- package/examples/browser/vue/node_modules/postcss/lib/no-work-result.js +0 -138
- package/examples/browser/vue/node_modules/postcss/lib/node.d.ts +0 -556
- package/examples/browser/vue/node_modules/postcss/lib/node.js +0 -449
- package/examples/browser/vue/node_modules/postcss/lib/parse.d.ts +0 -9
- package/examples/browser/vue/node_modules/postcss/lib/parse.js +0 -42
- package/examples/browser/vue/node_modules/postcss/lib/parser.js +0 -611
- package/examples/browser/vue/node_modules/postcss/lib/postcss.d.mts +0 -69
- package/examples/browser/vue/node_modules/postcss/lib/postcss.d.ts +0 -458
- package/examples/browser/vue/node_modules/postcss/lib/postcss.js +0 -101
- package/examples/browser/vue/node_modules/postcss/lib/postcss.mjs +0 -30
- package/examples/browser/vue/node_modules/postcss/lib/previous-map.d.ts +0 -81
- package/examples/browser/vue/node_modules/postcss/lib/previous-map.js +0 -144
- package/examples/browser/vue/node_modules/postcss/lib/processor.d.ts +0 -115
- package/examples/browser/vue/node_modules/postcss/lib/processor.js +0 -67
- package/examples/browser/vue/node_modules/postcss/lib/result.d.ts +0 -205
- package/examples/browser/vue/node_modules/postcss/lib/result.js +0 -42
- package/examples/browser/vue/node_modules/postcss/lib/root.d.ts +0 -87
- package/examples/browser/vue/node_modules/postcss/lib/root.js +0 -61
- package/examples/browser/vue/node_modules/postcss/lib/rule.d.ts +0 -126
- package/examples/browser/vue/node_modules/postcss/lib/rule.js +0 -27
- package/examples/browser/vue/node_modules/postcss/lib/stringifier.d.ts +0 -46
- package/examples/browser/vue/node_modules/postcss/lib/stringifier.js +0 -353
- package/examples/browser/vue/node_modules/postcss/lib/stringify.d.ts +0 -9
- package/examples/browser/vue/node_modules/postcss/lib/stringify.js +0 -11
- package/examples/browser/vue/node_modules/postcss/lib/symbols.js +0 -5
- package/examples/browser/vue/node_modules/postcss/lib/terminal-highlight.js +0 -70
- package/examples/browser/vue/node_modules/postcss/lib/tokenize.js +0 -266
- package/examples/browser/vue/node_modules/postcss/lib/warn-once.js +0 -13
- package/examples/browser/vue/node_modules/postcss/lib/warning.d.ts +0 -147
- package/examples/browser/vue/node_modules/postcss/lib/warning.js +0 -37
- package/examples/browser/vue/node_modules/postcss/package.json +0 -88
- package/examples/browser/vue/node_modules/rollup/LICENSE.md +0 -679
- package/examples/browser/vue/node_modules/rollup/README.md +0 -134
- package/examples/browser/vue/node_modules/rollup/dist/bin/rollup +0 -1912
- package/examples/browser/vue/node_modules/rollup/dist/es/getLogFilter.js +0 -64
- package/examples/browser/vue/node_modules/rollup/dist/es/package.json +0 -1
- package/examples/browser/vue/node_modules/rollup/dist/es/parseAst.js +0 -12
- package/examples/browser/vue/node_modules/rollup/dist/es/rollup.js +0 -17
- package/examples/browser/vue/node_modules/rollup/dist/es/shared/node-entry.js +0 -23920
- package/examples/browser/vue/node_modules/rollup/dist/es/shared/parseAst.js +0 -2086
- package/examples/browser/vue/node_modules/rollup/dist/es/shared/watch.js +0 -9297
- package/examples/browser/vue/node_modules/rollup/dist/getLogFilter.d.ts +0 -5
- package/examples/browser/vue/node_modules/rollup/dist/getLogFilter.js +0 -69
- package/examples/browser/vue/node_modules/rollup/dist/loadConfigFile.d.ts +0 -20
- package/examples/browser/vue/node_modules/rollup/dist/loadConfigFile.js +0 -29
- package/examples/browser/vue/node_modules/rollup/dist/native.js +0 -129
- package/examples/browser/vue/node_modules/rollup/dist/parseAst.d.ts +0 -4
- package/examples/browser/vue/node_modules/rollup/dist/parseAst.js +0 -22
- package/examples/browser/vue/node_modules/rollup/dist/rollup.d.ts +0 -1185
- package/examples/browser/vue/node_modules/rollup/dist/rollup.js +0 -127
- package/examples/browser/vue/node_modules/rollup/dist/shared/fsevents-importer.js +0 -37
- package/examples/browser/vue/node_modules/rollup/dist/shared/index.js +0 -9003
- package/examples/browser/vue/node_modules/rollup/dist/shared/loadConfigFile.js +0 -572
- package/examples/browser/vue/node_modules/rollup/dist/shared/parseAst.js +0 -2318
- package/examples/browser/vue/node_modules/rollup/dist/shared/rollup.js +0 -23842
- package/examples/browser/vue/node_modules/rollup/dist/shared/watch-cli.js +0 -542
- package/examples/browser/vue/node_modules/rollup/dist/shared/watch.js +0 -324
- package/examples/browser/vue/node_modules/rollup/package.json +0 -273
- package/examples/browser/vue/node_modules/source-map-js/LICENSE +0 -28
- package/examples/browser/vue/node_modules/source-map-js/README.md +0 -765
- package/examples/browser/vue/node_modules/source-map-js/lib/array-set.js +0 -121
- package/examples/browser/vue/node_modules/source-map-js/lib/base64-vlq.js +0 -140
- package/examples/browser/vue/node_modules/source-map-js/lib/base64.js +0 -67
- package/examples/browser/vue/node_modules/source-map-js/lib/binary-search.js +0 -111
- package/examples/browser/vue/node_modules/source-map-js/lib/mapping-list.js +0 -79
- package/examples/browser/vue/node_modules/source-map-js/lib/quick-sort.js +0 -132
- package/examples/browser/vue/node_modules/source-map-js/lib/source-map-consumer.d.ts +0 -1
- package/examples/browser/vue/node_modules/source-map-js/lib/source-map-consumer.js +0 -1188
- package/examples/browser/vue/node_modules/source-map-js/lib/source-map-generator.d.ts +0 -1
- package/examples/browser/vue/node_modules/source-map-js/lib/source-map-generator.js +0 -444
- package/examples/browser/vue/node_modules/source-map-js/lib/source-node.d.ts +0 -1
- package/examples/browser/vue/node_modules/source-map-js/lib/source-node.js +0 -413
- package/examples/browser/vue/node_modules/source-map-js/lib/util.js +0 -594
- package/examples/browser/vue/node_modules/source-map-js/package.json +0 -71
- package/examples/browser/vue/node_modules/source-map-js/source-map.d.ts +0 -104
- package/examples/browser/vue/node_modules/source-map-js/source-map.js +0 -8
- package/examples/browser/vue/node_modules/vite/LICENSE.md +0 -3423
- package/examples/browser/vue/node_modules/vite/README.md +0 -20
- package/examples/browser/vue/node_modules/vite/bin/openChrome.applescript +0 -95
- package/examples/browser/vue/node_modules/vite/bin/vite.js +0 -61
- package/examples/browser/vue/node_modules/vite/client.d.ts +0 -256
- package/examples/browser/vue/node_modules/vite/dist/client/client.mjs +0 -829
- package/examples/browser/vue/node_modules/vite/dist/client/env.mjs +0 -24
- package/examples/browser/vue/node_modules/vite/dist/node/chunks/dep-D-7KCb9p.js +0 -7960
- package/examples/browser/vue/node_modules/vite/dist/node/chunks/dep-D_zLpgQd.js +0 -67047
- package/examples/browser/vue/node_modules/vite/dist/node/chunks/dep-IQS-Za7F.js +0 -561
- package/examples/browser/vue/node_modules/vite/dist/node/chunks/dep-YkMKzX4u.js +0 -993
- package/examples/browser/vue/node_modules/vite/dist/node/chunks/dep-e9kYborm.js +0 -7004
- package/examples/browser/vue/node_modules/vite/dist/node/cli.js +0 -917
- package/examples/browser/vue/node_modules/vite/dist/node/constants.js +0 -113
- package/examples/browser/vue/node_modules/vite/dist/node/index.d.ts +0 -3627
- package/examples/browser/vue/node_modules/vite/dist/node/index.js +0 -261
- package/examples/browser/vue/node_modules/vite/dist/node/runtime.d.ts +0 -63
- package/examples/browser/vue/node_modules/vite/dist/node/runtime.js +0 -1066
- package/examples/browser/vue/node_modules/vite/dist/node/types.d-aGj9QkWt.d.ts +0 -281
- package/examples/browser/vue/node_modules/vite/dist/node-cjs/publicUtils.cjs +0 -6171
- package/examples/browser/vue/node_modules/vite/index.cjs +0 -60
- package/examples/browser/vue/node_modules/vite/index.d.cts +0 -6
- package/examples/browser/vue/node_modules/vite/package.json +0 -191
- package/examples/browser/vue/node_modules/vite/types/customEvent.d.ts +0 -39
- package/examples/browser/vue/node_modules/vite/types/hmrPayload.d.ts +0 -65
- package/examples/browser/vue/node_modules/vite/types/hot.d.ts +0 -36
- package/examples/browser/vue/node_modules/vite/types/import-meta.d.ts +0 -5
- package/examples/browser/vue/node_modules/vite/types/importGlob.d.ts +0 -75
- package/examples/browser/vue/node_modules/vite/types/importMeta.d.ts +0 -22
- package/examples/browser/vue/node_modules/vite/types/metadata.d.ts +0 -10
- package/examples/browser/vue/node_modules/vite/types/package.json +0 -4
- package/examples/browser/vue/node_modules/vue/LICENSE +0 -21
- package/examples/browser/vue/node_modules/vue/README.md +0 -62
- package/examples/browser/vue/node_modules/vue/compiler-sfc/index.browser.js +0 -1
- package/examples/browser/vue/node_modules/vue/compiler-sfc/index.browser.mjs +0 -1
- package/examples/browser/vue/node_modules/vue/compiler-sfc/index.d.mts +0 -1
- package/examples/browser/vue/node_modules/vue/compiler-sfc/index.d.ts +0 -1
- package/examples/browser/vue/node_modules/vue/compiler-sfc/index.js +0 -3
- package/examples/browser/vue/node_modules/vue/compiler-sfc/index.mjs +0 -3
- package/examples/browser/vue/node_modules/vue/compiler-sfc/package.json +0 -4
- package/examples/browser/vue/node_modules/vue/compiler-sfc/register-ts.js +0 -3
- package/examples/browser/vue/node_modules/vue/dist/vue.cjs.js +0 -80
- package/examples/browser/vue/node_modules/vue/dist/vue.cjs.prod.js +0 -66
- package/examples/browser/vue/node_modules/vue/dist/vue.d.mts +0 -7
- package/examples/browser/vue/node_modules/vue/dist/vue.d.ts +0 -7
- package/examples/browser/vue/node_modules/vue/dist/vue.esm-browser.js +0 -18392
- package/examples/browser/vue/node_modules/vue/dist/vue.esm-browser.prod.js +0 -12
- package/examples/browser/vue/node_modules/vue/dist/vue.esm-bundler.js +0 -71
- package/examples/browser/vue/node_modules/vue/dist/vue.global.js +0 -18272
- package/examples/browser/vue/node_modules/vue/dist/vue.global.prod.js +0 -12
- package/examples/browser/vue/node_modules/vue/dist/vue.runtime.esm-browser.js +0 -12522
- package/examples/browser/vue/node_modules/vue/dist/vue.runtime.esm-browser.prod.js +0 -6
- package/examples/browser/vue/node_modules/vue/dist/vue.runtime.esm-bundler.js +0 -26
- package/examples/browser/vue/node_modules/vue/dist/vue.runtime.global.js +0 -12574
- package/examples/browser/vue/node_modules/vue/dist/vue.runtime.global.prod.js +0 -6
- package/examples/browser/vue/node_modules/vue/index.js +0 -7
- package/examples/browser/vue/node_modules/vue/index.mjs +0 -1
- package/examples/browser/vue/node_modules/vue/jsx-runtime/index.d.ts +0 -25
- package/examples/browser/vue/node_modules/vue/jsx-runtime/index.js +0 -15
- package/examples/browser/vue/node_modules/vue/jsx-runtime/index.mjs +0 -12
- package/examples/browser/vue/node_modules/vue/jsx-runtime/package.json +0 -5
- package/examples/browser/vue/node_modules/vue/jsx.d.ts +0 -22
- package/examples/browser/vue/node_modules/vue/package.json +0 -112
- package/examples/browser/vue/node_modules/vue/server-renderer/index.d.mts +0 -1
- package/examples/browser/vue/node_modules/vue/server-renderer/index.d.ts +0 -1
- package/examples/browser/vue/node_modules/vue/server-renderer/index.js +0 -1
- package/examples/browser/vue/node_modules/vue/server-renderer/index.mjs +0 -1
- package/examples/browser/vue/node_modules/vue/server-renderer/package.json +0 -4
- package/examples/browser/vue/node_modules/vue-demi/LICENSE +0 -21
- package/examples/browser/vue/node_modules/vue-demi/README.md +0 -229
- package/examples/browser/vue/node_modules/vue-demi/bin/vue-demi-fix.js +0 -3
- package/examples/browser/vue/node_modules/vue-demi/bin/vue-demi-switch.js +0 -3
- package/examples/browser/vue/node_modules/vue-demi/lib/index.cjs +0 -29
- package/examples/browser/vue/node_modules/vue-demi/lib/index.d.ts +0 -22
- package/examples/browser/vue/node_modules/vue-demi/lib/index.iife.js +0 -126
- package/examples/browser/vue/node_modules/vue-demi/lib/index.mjs +0 -34
- package/examples/browser/vue/node_modules/vue-demi/lib/v2/index.cjs +0 -34
- package/examples/browser/vue/node_modules/vue-demi/lib/v2/index.d.ts +0 -33
- package/examples/browser/vue/node_modules/vue-demi/lib/v2/index.mjs +0 -49
- package/examples/browser/vue/node_modules/vue-demi/lib/v2.7/index.cjs +0 -60
- package/examples/browser/vue/node_modules/vue-demi/lib/v2.7/index.d.ts +0 -38
- package/examples/browser/vue/node_modules/vue-demi/lib/v2.7/index.mjs +0 -80
- package/examples/browser/vue/node_modules/vue-demi/lib/v3/index.cjs +0 -29
- package/examples/browser/vue/node_modules/vue-demi/lib/v3/index.d.ts +0 -22
- package/examples/browser/vue/node_modules/vue-demi/lib/v3/index.mjs +0 -34
- package/examples/browser/vue/node_modules/vue-demi/package.json +0 -47
- package/examples/browser/vue/node_modules/vue-demi/scripts/postinstall.js +0 -19
- package/examples/browser/vue/node_modules/vue-demi/scripts/switch-cli.js +0 -18
- package/examples/browser/vue/node_modules/vue-demi/scripts/utils.js +0 -62
- package/examples/browser/vue/node_modules/vue-router/LICENSE +0 -21
- package/examples/browser/vue/node_modules/vue-router/README.md +0 -111
- package/examples/browser/vue/node_modules/vue-router/dist/devtools-BLCumUwL.mjs +0 -1218
- package/examples/browser/vue/node_modules/vue-router/dist/experimental/index.d.mts +0 -38
- package/examples/browser/vue/node_modules/vue-router/dist/experimental/index.mjs +0 -754
- package/examples/browser/vue/node_modules/vue-router/dist/router-BbqN7H95.d.mts +0 -1928
- package/examples/browser/vue/node_modules/vue-router/dist/vue-router.cjs +0 -2797
- package/examples/browser/vue/node_modules/vue-router/dist/vue-router.d.mts +0 -393
- package/examples/browser/vue/node_modules/vue-router/dist/vue-router.esm-browser.js +0 -2743
- package/examples/browser/vue/node_modules/vue-router/dist/vue-router.esm-browser.prod.js +0 -6
- package/examples/browser/vue/node_modules/vue-router/dist/vue-router.esm-bundler.js +0 -2
- package/examples/browser/vue/node_modules/vue-router/dist/vue-router.global.js +0 -3040
- package/examples/browser/vue/node_modules/vue-router/dist/vue-router.global.prod.js +0 -6
- package/examples/browser/vue/node_modules/vue-router/dist/vue-router.mjs +0 -1557
- package/examples/browser/vue/node_modules/vue-router/dist/vue-router.prod.cjs +0 -23
- package/examples/browser/vue/node_modules/vue-router/index.js +0 -7
- package/examples/browser/vue/node_modules/vue-router/package.json +0 -154
- package/examples/browser/vue/node_modules/vue-router/vetur/attributes.json +0 -32
- package/examples/browser/vue/node_modules/vue-router/vetur/tags.json +0 -10
- package/examples/browser/vue/node_modules/vue-router/vue-router-auto-resolver.d.mts +0 -22
- package/examples/browser/vue/node_modules/vue-router/vue-router-auto-routes.d.ts +0 -4
- package/examples/browser/vue/node_modules/vue-router/vue-router-auto.d.ts +0 -1
- package/examples/browser/vue/node_modules/vue-router/vue-router.node.mjs +0 -2
- package/examples/browser/vue/package-lock.json +0 -1276
- package/examples/browser/vue/package.json +0 -23
- package/examples/browser/vue/public/peerpigeon-browser.js +0 -13322
- package/examples/browser/vue/public/pigeonlogo.svg +0 -51
- package/examples/browser/vue/src/App-simple.vue +0 -21
- package/examples/browser/vue/src/App.vue +0 -423
- package/examples/browser/vue/src/components/CryptoView.vue +0 -1661
- package/examples/browser/vue/src/components/DHTView.vue +0 -1281
- package/examples/browser/vue/src/components/DebugView.vue +0 -1783
- package/examples/browser/vue/src/components/MediaView.vue +0 -1197
- package/examples/browser/vue/src/components/MessagingView.vue +0 -803
- package/examples/browser/vue/src/components/NetworkView.vue +0 -930
- package/examples/browser/vue/src/components/StorageView.vue +0 -1376
- package/examples/browser/vue/src/components/TestingView.vue +0 -794
- package/examples/browser/vue/src/main.js +0 -11
- package/examples/browser/vue/src/router.js +0 -63
- package/examples/browser/vue/src/stores/peerpigeon.js +0 -1334
- package/examples/browser/vue/test-vue-restructured-2.log +0 -18
- package/examples/browser/vue/test-vue-restructured-3.log +0 -18
- package/examples/browser/vue/vite.config.js +0 -22
- package/examples/debug-configuration.js +0 -171
- package/examples/hub-example.js +0 -189
- package/examples/multi-hub-test.js +0 -186
- package/examples/nativescript/README.md +0 -73
- package/examples/nativescript/app.js +0 -152
- package/examples/nativescript/package.json +0 -27
- package/examples/node/README.md +0 -110
- package/examples/node/basic-storage-example.js +0 -90
- package/examples/node/package.json +0 -17
- package/examples/node/storage-spaces-test.js +0 -329
- package/examples/node/storage-test.js +0 -655
- package/examples/node/test-crypto-media.js +0 -137
- package/examples/node/test-crypto.js +0 -146
- package/examples/node/test-node.js +0 -152
- package/examples/programmatic-namespace-example.js +0 -108
- package/examples/selective-streaming-demo.html +0 -698
- package/examples/standard-events-demo.js +0 -126
- package/examples/stream-file-transfer-demo.html +0 -935
- package/index.js +0 -30
- package/server/index.js +0 -2147
- package/server/start.js +0 -52
- package/src/CleanupManager.js +0 -183
- package/src/ConnectionManager.js +0 -1286
- package/src/CryptoManager.js +0 -743
- package/src/DebugLogger.js +0 -204
- package/src/DistributedStorageManager.js +0 -1741
- package/src/EnvironmentDetector.js +0 -600
- package/src/EventEmitter.js +0 -106
- package/src/EvictionManager.js +0 -260
- package/src/GossipManager.js +0 -726
- package/src/LexicalStorageInterface.js +0 -332
- package/src/MediaManager.js +0 -276
- package/src/MeshOptimizer.js +0 -182
- package/src/PeerConnection.js +0 -1850
- package/src/PeerDiscovery.js +0 -329
- package/src/PeerPigeonMesh.js +0 -2502
- package/src/PigeonRTC-browser.js +0 -247
- package/src/SignalingClient.js +0 -395
- package/src/SignalingHandler.js +0 -589
- package/src/StorageManager.js +0 -107
- package/src/TimerUtils.js +0 -75
- package/src/WebDHT-Simple.js +0 -389
- package/src/WebDHT.js +0 -474
- package/src/browser-entry.js +0 -68
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,2027 @@
|
|
|
1
|
+
declare const STORAGE_SERVER_NETWORK = "peerpigeon-storage";
|
|
2
|
+
declare const STORAGE_SERVER_ROOM = "servers";
|
|
3
|
+
declare const STORAGE_SERVER_ROLE = "storage";
|
|
4
|
+
/** Servers per room. */
|
|
5
|
+
declare const STORAGE_REPLICAS = 3;
|
|
6
|
+
/** One record as a server keeps it. Every field is a hash or ciphertext, except `at` and `once`. */
|
|
7
|
+
interface ServerRecord {
|
|
8
|
+
/** sha256 of the room's secret: which room. */
|
|
9
|
+
room: string;
|
|
10
|
+
/** sha256 of the room's secret, space and key: which record. */
|
|
11
|
+
slot: string;
|
|
12
|
+
/** sha256 of the room's secret and space (16 hex): which space, for listing. */
|
|
13
|
+
tag: string;
|
|
14
|
+
/** When it was written (the mutation's timestamp, ms): a newer one replaces it. */
|
|
15
|
+
at: number;
|
|
16
|
+
/** The room-encrypted mutation. */
|
|
17
|
+
blob: unknown;
|
|
18
|
+
/** sha256 of the slot's write token. */
|
|
19
|
+
wh: string;
|
|
20
|
+
/** Write-once (frozen). */
|
|
21
|
+
once?: boolean;
|
|
22
|
+
/** A user record's owner (its signing key): only writes it signs replace it. */
|
|
23
|
+
owner?: string;
|
|
24
|
+
/** The owner's signature of ownerText(this record). */
|
|
25
|
+
osig?: string;
|
|
26
|
+
}
|
|
27
|
+
/** Largest blob: one message, base64, under a data channel's limit. */
|
|
28
|
+
declare const MAX_BLOB_BYTES: number;
|
|
29
|
+
/** Where a blob with this SHA-256 is kept (what servers see). */
|
|
30
|
+
declare function blobAddress(hash: string): Promise<string>;
|
|
31
|
+
/** Seals content for the servers: its address, and the bytes a server keeps. */
|
|
32
|
+
declare function sealBlob(bytes: Uint8Array): Promise<{
|
|
33
|
+
hash: string;
|
|
34
|
+
address: string;
|
|
35
|
+
sealed: Uint8Array;
|
|
36
|
+
}>;
|
|
37
|
+
/** Opens a sealed blob; null unless it is the content with that SHA-256. */
|
|
38
|
+
declare function openBlob(hash: string, sealed: Uint8Array): Promise<Uint8Array | null>;
|
|
39
|
+
/**
|
|
40
|
+
* A room only one key writes to (a person's own records): 'o' and the hash of that key. A server
|
|
41
|
+
* takes a record for it only when the record carries that key as its owner, signed by it; so
|
|
42
|
+
* nobody else, knowing the key or not, can put anything in it.
|
|
43
|
+
*/
|
|
44
|
+
declare function ownedRoomOf(owner: string): Promise<string>;
|
|
45
|
+
/** A room id: 64 hex (a shared room), or 'o' and 64 hex (an owned room). */
|
|
46
|
+
declare function validRoom(v: unknown): v is string;
|
|
47
|
+
type LinkListener = (event: {
|
|
48
|
+
type: 'servers';
|
|
49
|
+
room: string;
|
|
50
|
+
servers: string[];
|
|
51
|
+
} | {
|
|
52
|
+
type: 'changed';
|
|
53
|
+
rec: Omit<ServerRecord, 'wh'>;
|
|
54
|
+
}) => void;
|
|
55
|
+
/**
|
|
56
|
+
* A peer's link to the storage servers: a small PeerPigeon node in the
|
|
57
|
+
* servers' scope that dials no one on its own, only the servers closest to the
|
|
58
|
+
* rooms it keeps.
|
|
59
|
+
*/
|
|
60
|
+
declare class StorageServerLink {
|
|
61
|
+
private readonly node;
|
|
62
|
+
private readonly hashed;
|
|
63
|
+
private readonly pending;
|
|
64
|
+
/** Servers that have sent us bytes (a blob, as bytes): they read them too. */
|
|
65
|
+
private readonly readsBytes;
|
|
66
|
+
private readonly listings;
|
|
67
|
+
private readonly rooms;
|
|
68
|
+
private readonly listeners;
|
|
69
|
+
private timer;
|
|
70
|
+
private closed;
|
|
71
|
+
constructor(node: PeerPigeonNode);
|
|
72
|
+
start(): Promise<void>;
|
|
73
|
+
close(): Promise<void>;
|
|
74
|
+
on(listener: LinkListener): () => void;
|
|
75
|
+
/** Keep this room: link to its closest servers, and hear of changes to it. */
|
|
76
|
+
keep(room: string): void;
|
|
77
|
+
/** The linked servers that keep this room, closest first. */
|
|
78
|
+
serversFor(room: string): string[];
|
|
79
|
+
/** Every server listed in the servers' scope. */
|
|
80
|
+
knownServers(): Promise<string[]>;
|
|
81
|
+
private refreshing;
|
|
82
|
+
private refreshAgain;
|
|
83
|
+
/** Looks again at the servers; one asked for while a look is under way runs after it. */
|
|
84
|
+
private refresh;
|
|
85
|
+
private refreshNow;
|
|
86
|
+
private emit;
|
|
87
|
+
private send;
|
|
88
|
+
private ask;
|
|
89
|
+
private failPending;
|
|
90
|
+
private onMessage;
|
|
91
|
+
/** Writes a record to the room's servers; resolves with how many took it. */
|
|
92
|
+
put(rec: Omit<ServerRecord, 'wh'>, write: string): Promise<number>;
|
|
93
|
+
/** The newest copy of a record the room's servers hold, or null. */
|
|
94
|
+
get(room: string, slot: string): Promise<Omit<ServerRecord, 'wh'> | null>;
|
|
95
|
+
/** The servers closest to a blob's address, linked (waits up to `waitMs` for new links). */
|
|
96
|
+
private serversForBlob;
|
|
97
|
+
/** Whether any server is known in the scope (linked or not). */
|
|
98
|
+
hasServers(): Promise<boolean>;
|
|
99
|
+
/** Keeps content on the servers closest to it; resolves with how many took it. */
|
|
100
|
+
putBlob(bytes: Uint8Array): Promise<number>;
|
|
101
|
+
/** Content by its SHA-256 from the servers, checked; null if none has it. */
|
|
102
|
+
getBlob(hash: string): Promise<Uint8Array | null>;
|
|
103
|
+
/** Every record the room's servers hold (of one space, with `tag`), the newest copy of each. */
|
|
104
|
+
list(room: string, tag?: string): Promise<Omit<ServerRecord, 'wh'>[]>;
|
|
105
|
+
}
|
|
106
|
+
/** Where a server keeps records: memory by default, a disk or a database in a real server. */
|
|
107
|
+
interface ServerRecordStore {
|
|
108
|
+
get(room: string, slot: string): Promise<ServerRecord | null>;
|
|
109
|
+
put(rec: ServerRecord): Promise<void>;
|
|
110
|
+
list(room: string, tag?: string): Promise<ServerRecord[]>;
|
|
111
|
+
rooms(): Promise<string[]>;
|
|
112
|
+
/** Sealed blobs by address (a store without them keeps records only). */
|
|
113
|
+
getBlob?(address: string): Promise<Uint8Array | null>;
|
|
114
|
+
putBlob?(address: string, sealed: Uint8Array): Promise<void>;
|
|
115
|
+
blobs?(): Promise<string[]>;
|
|
116
|
+
blobUsage?(): Promise<{
|
|
117
|
+
count: number;
|
|
118
|
+
bytes: number;
|
|
119
|
+
}>;
|
|
120
|
+
}
|
|
121
|
+
declare class MemoryServerRecordStore implements ServerRecordStore {
|
|
122
|
+
private readonly byRoom;
|
|
123
|
+
get(room: string, slot: string): Promise<ServerRecord | null>;
|
|
124
|
+
put(rec: ServerRecord): Promise<void>;
|
|
125
|
+
list(room: string, tag?: string): Promise<ServerRecord[]>;
|
|
126
|
+
rooms(): Promise<string[]>;
|
|
127
|
+
private readonly blobMap;
|
|
128
|
+
getBlob(address: string): Promise<Uint8Array<ArrayBufferLike> | null>;
|
|
129
|
+
putBlob(address: string, sealed: Uint8Array): Promise<void>;
|
|
130
|
+
blobs(): Promise<string[]>;
|
|
131
|
+
blobUsage(): Promise<{
|
|
132
|
+
count: number;
|
|
133
|
+
bytes: number;
|
|
134
|
+
}>;
|
|
135
|
+
}
|
|
136
|
+
interface StorageServerStats {
|
|
137
|
+
rooms: number;
|
|
138
|
+
records: number;
|
|
139
|
+
blobs: number;
|
|
140
|
+
blobBytes: number;
|
|
141
|
+
servers: number;
|
|
142
|
+
clients: number;
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* A storage server: keeps the records of the rooms it is among the closest
|
|
146
|
+
* servers for, answers the peers linked to it, tells the peers watching a room
|
|
147
|
+
* what changed in it, and hands each room's records to whichever servers are
|
|
148
|
+
* closest to it as servers come and go.
|
|
149
|
+
*/
|
|
150
|
+
declare class StorageServer {
|
|
151
|
+
private readonly node;
|
|
152
|
+
private readonly store;
|
|
153
|
+
private readonly hashed;
|
|
154
|
+
private readonly watchers;
|
|
155
|
+
/** For each room: the servers last given its records. */
|
|
156
|
+
private readonly placed;
|
|
157
|
+
/** For each blob: the servers last given it. */
|
|
158
|
+
private readonly placedBlobs;
|
|
159
|
+
private selfHash;
|
|
160
|
+
private timer;
|
|
161
|
+
private onChange;
|
|
162
|
+
constructor(node: PeerPigeonNode, store?: ServerRecordStore);
|
|
163
|
+
/** Called with each record this server takes (a write, or one handed to it). */
|
|
164
|
+
onRecord(listener: (rec: ServerRecord) => void): void;
|
|
165
|
+
start(): Promise<void>;
|
|
166
|
+
close(): Promise<void>;
|
|
167
|
+
stats(): Promise<StorageServerStats>;
|
|
168
|
+
private self;
|
|
169
|
+
/** Every server known in the scope, this one included. */
|
|
170
|
+
private servers;
|
|
171
|
+
private send;
|
|
172
|
+
/** Takes a record if it is new or newer, and its write token (or hash) is the slot's. */
|
|
173
|
+
private take;
|
|
174
|
+
private onMessage;
|
|
175
|
+
private rebalancing;
|
|
176
|
+
private rebalanceAgain;
|
|
177
|
+
rebalance(): Promise<void>;
|
|
178
|
+
/**
|
|
179
|
+
* Hands each room's records to the servers now closest to it that were not
|
|
180
|
+
* given them yet: a server that joins gets the rooms it is now closest for,
|
|
181
|
+
* and when one leaves, the next closest gets its rooms.
|
|
182
|
+
*/
|
|
183
|
+
private rebalanceNow;
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
/**
|
|
187
|
+
* A path for signaling frames that does not go through the relay: the
|
|
188
|
+
* mesh itself. `canRoute` says whether a frame for that peer has somewhere
|
|
189
|
+
* to go; `send` hands the complete PSP envelope to the mesh and reports
|
|
190
|
+
* whether it was taken. Any frame the mesh declines falls back to the relay.
|
|
191
|
+
*/
|
|
192
|
+
interface MeshSignaling {
|
|
193
|
+
canRoute(peerId: string): boolean;
|
|
194
|
+
send(envelope: Record<string, unknown>): boolean;
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
type GossipProtocolOptions = {
|
|
198
|
+
/** Maximum number of re-propagation hops for a message. */
|
|
199
|
+
maxHops?: number;
|
|
200
|
+
/** Maximum hops for a direct/routed message before it is dropped. Default 256. */
|
|
201
|
+
maxDirectHops?: number;
|
|
202
|
+
/** Relative weight of coordinate-space distance in CECR hybrid routing (0..1). */
|
|
203
|
+
cecrCoordinateWeight?: number;
|
|
204
|
+
/** Maximum age of extrema snapshot before coordinate weight is reduced. */
|
|
205
|
+
cecrExtremaMaxAgeMs?: number;
|
|
206
|
+
/** @deprecated CECR v1 uses readiness gating instead of a claimed drift threshold. */
|
|
207
|
+
cecrMaxAcceptedDrift?: number;
|
|
208
|
+
/** Require canonical global-set/extrema agreement across connected peers before coordinate routing. */
|
|
209
|
+
cecrRequireConsensus?: boolean;
|
|
210
|
+
/** Consecutive state rounds required before coordinate routing. Default 3. */
|
|
211
|
+
cecrConvergenceRounds?: number;
|
|
212
|
+
/** Default deadline for opt-in tracked gossip delivery. Default 30 seconds. */
|
|
213
|
+
deliveryTimeoutMs?: number;
|
|
214
|
+
/** @deprecated Initial targeted repair is immediate; retained for API compatibility. */
|
|
215
|
+
deliveryRepairDelayMs?: number;
|
|
216
|
+
/** Minimum delay between repeated repair attempts for the same target. Default 5 seconds. */
|
|
217
|
+
deliveryRepairIntervalMs?: number;
|
|
218
|
+
/** Maximum recent broadcast IDs advertised per epidemic anti-entropy summary. Default 256. */
|
|
219
|
+
antiEntropySummarySize?: number;
|
|
220
|
+
/** Maximum missing broadcasts requested or served per anti-entropy exchange. Default 64. */
|
|
221
|
+
antiEntropyRequestSize?: number;
|
|
222
|
+
/**
|
|
223
|
+
* Learn routes from broadcasts (CECR v1.2, Section 8.5): a broadcast that
|
|
224
|
+
* arrives proves the link it came over leads back to its sender, and a
|
|
225
|
+
* small route ack sent back up the broadcast's path proves the forward
|
|
226
|
+
* links. Direct messages try a fresh learned route before the greedy
|
|
227
|
+
* order. Default true.
|
|
228
|
+
*/
|
|
229
|
+
learnRoutes?: boolean;
|
|
230
|
+
/** How long a learned route stays usable. Default 30 seconds. */
|
|
231
|
+
learnedRouteMaxAgeMs?: number;
|
|
232
|
+
};
|
|
233
|
+
type CecrConfigSnapshot = {
|
|
234
|
+
protocol: 'cecr/1';
|
|
235
|
+
configId: string;
|
|
236
|
+
idWidthBits: 256;
|
|
237
|
+
hashProfile: 'fnv1a64-compat';
|
|
238
|
+
signatureProfile: 'unsigned-partial';
|
|
239
|
+
coordinateWeightNumerator: number;
|
|
240
|
+
coordinateWeightDenominator: number;
|
|
241
|
+
extremaMaxAgeMs: number;
|
|
242
|
+
requireConsensus: boolean;
|
|
243
|
+
maxDirectHops: number;
|
|
244
|
+
membershipLeaseMs: number;
|
|
245
|
+
membershipGossipIntervalMs: number;
|
|
246
|
+
membershipTombstoneRetentionMs: number;
|
|
247
|
+
membershipClockSkewMs: number;
|
|
248
|
+
convergenceRounds: number;
|
|
249
|
+
xorBucketRedundancy: 1;
|
|
250
|
+
};
|
|
251
|
+
type CecrOverlaySnapshot = {
|
|
252
|
+
xorBucketCoverage: boolean;
|
|
253
|
+
coordinateAdjacency: boolean;
|
|
254
|
+
missingXorBuckets: number[];
|
|
255
|
+
missingCoordinatePeerIds: string[];
|
|
256
|
+
degraded: boolean;
|
|
257
|
+
};
|
|
258
|
+
type CecrStateSnapshot = {
|
|
259
|
+
protocol: 'cecr/1';
|
|
260
|
+
conformance: 'partial';
|
|
261
|
+
configId: string;
|
|
262
|
+
peerId: string | null;
|
|
263
|
+
livePeerIds: string[];
|
|
264
|
+
viewId: string;
|
|
265
|
+
viewStableForMs: number;
|
|
266
|
+
requiredStableForMs: number;
|
|
267
|
+
size: number;
|
|
268
|
+
/** Largest fresh CECR/aggregate observation of total live network size. */
|
|
269
|
+
networkSizeEstimate: number;
|
|
270
|
+
minHex: string | null;
|
|
271
|
+
maxHex: string | null;
|
|
272
|
+
coordinateReady: boolean;
|
|
273
|
+
connectedDegree: number;
|
|
274
|
+
fanout: number;
|
|
275
|
+
membershipRecords: Array<{
|
|
276
|
+
peerId: string;
|
|
277
|
+
incarnation: number;
|
|
278
|
+
sequence: number;
|
|
279
|
+
state: 'alive' | 'left';
|
|
280
|
+
issuedAt: number;
|
|
281
|
+
validUntil: number | null;
|
|
282
|
+
}>;
|
|
283
|
+
membershipEquivocations: string[];
|
|
284
|
+
overlay: CecrOverlaySnapshot;
|
|
285
|
+
limitations: string[];
|
|
286
|
+
};
|
|
287
|
+
type GossipBroadcastOptions = {
|
|
288
|
+
/** Track delivery to the canonical known-peer snapshot captured at send time. */
|
|
289
|
+
trackDelivery?: boolean;
|
|
290
|
+
/**
|
|
291
|
+
* Confirm reach with a reverse convergecast. Each peer reports one aggregate
|
|
292
|
+
* subtree count to its first-arrival parent; no peer list or per-peer bitset
|
|
293
|
+
* is attached to the message or collected by the sender.
|
|
294
|
+
*/
|
|
295
|
+
aggregateDelivery?: boolean;
|
|
296
|
+
/** Override the deadline for this message's initial dissemination and delivery inference. */
|
|
297
|
+
deliveryTimeoutMs?: number;
|
|
298
|
+
};
|
|
299
|
+
type GossipDeliveryStatus = {
|
|
300
|
+
messageId: string;
|
|
301
|
+
sender: string;
|
|
302
|
+
membershipHash: string;
|
|
303
|
+
audiencePeerIds: string[];
|
|
304
|
+
deliveredPeerIds: string[];
|
|
305
|
+
pendingPeerIds: string[];
|
|
306
|
+
audienceCount: number;
|
|
307
|
+
deliveredCount: number;
|
|
308
|
+
complete: boolean;
|
|
309
|
+
timedOut: boolean;
|
|
310
|
+
createdAt: number;
|
|
311
|
+
updatedAt: number;
|
|
312
|
+
deadlineAt: number;
|
|
313
|
+
};
|
|
314
|
+
type GossipAggregateDeliveryStatus = {
|
|
315
|
+
messageId: string;
|
|
316
|
+
sender: string;
|
|
317
|
+
/** Confirmed remote holders, excluding the sender. */
|
|
318
|
+
confirmedPeerCount: number;
|
|
319
|
+
/** Larger of current CECR membership and confirmed holders. */
|
|
320
|
+
inferredAudienceCount: number;
|
|
321
|
+
/** Deepest first-arrival hop represented by the aggregate. */
|
|
322
|
+
maxConfirmedHops: number;
|
|
323
|
+
/** True when the current dissemination tree has returned every branch. */
|
|
324
|
+
settled: boolean;
|
|
325
|
+
createdAt: number;
|
|
326
|
+
updatedAt: number;
|
|
327
|
+
deadlineAt: number;
|
|
328
|
+
};
|
|
329
|
+
type GossipDeliveryEnvelope = {
|
|
330
|
+
setHash: string;
|
|
331
|
+
size: number;
|
|
332
|
+
bits: string;
|
|
333
|
+
deadlineAt: number;
|
|
334
|
+
};
|
|
335
|
+
type GossipAggregateEnvelope = {
|
|
336
|
+
protocol: 'gossip-echo/1';
|
|
337
|
+
deadlineAt: number;
|
|
338
|
+
};
|
|
339
|
+
type GossipSpreadEnvelope = {
|
|
340
|
+
protocol: 'gossip-spread/1';
|
|
341
|
+
/** Initial CECR membership view. Payload repair is invalid after this view changes. */
|
|
342
|
+
setHash: string;
|
|
343
|
+
size: number;
|
|
344
|
+
/** Hard cutoff after which this payload must never be replayed. */
|
|
345
|
+
deadlineAt: number;
|
|
346
|
+
};
|
|
347
|
+
type GossipMessage = {
|
|
348
|
+
id: string;
|
|
349
|
+
timestamp: number;
|
|
350
|
+
hops: number;
|
|
351
|
+
maxHops: number;
|
|
352
|
+
sender: string | null;
|
|
353
|
+
data: unknown;
|
|
354
|
+
metadata: Record<string, unknown>;
|
|
355
|
+
type: 'gossip';
|
|
356
|
+
/** Bounded first-arrival route trace for diagnostics. */
|
|
357
|
+
path?: string[];
|
|
358
|
+
/** When each peer on the path sent it on (ms since epoch, its own clock), bounded like path. */
|
|
359
|
+
sentAt?: number[];
|
|
360
|
+
/**
|
|
361
|
+
* How long the message has been on its way, in ms, from local measurements
|
|
362
|
+
* only: at each hop the time it waited in that peer plus half the round
|
|
363
|
+
* trip of the link it then crossed. Unlike receivedAt - timestamp it does
|
|
364
|
+
* not depend on the sender's and receiver's clocks agreeing.
|
|
365
|
+
*/
|
|
366
|
+
transitMs?: number;
|
|
367
|
+
spread?: GossipSpreadEnvelope;
|
|
368
|
+
delivery?: GossipDeliveryEnvelope;
|
|
369
|
+
aggregate?: GossipAggregateEnvelope;
|
|
370
|
+
};
|
|
371
|
+
type DirectMessage = {
|
|
372
|
+
id: string;
|
|
373
|
+
type: 'direct';
|
|
374
|
+
from: string;
|
|
375
|
+
to: string;
|
|
376
|
+
data: unknown;
|
|
377
|
+
hops: number;
|
|
378
|
+
maxHops: number;
|
|
379
|
+
timestamp: number;
|
|
380
|
+
/** Bounded routed path, including source and current destination. */
|
|
381
|
+
path?: string[];
|
|
382
|
+
originConfigId?: string;
|
|
383
|
+
originViewId?: string;
|
|
384
|
+
};
|
|
385
|
+
type GossipStats = {
|
|
386
|
+
totalMessagesTracked: number;
|
|
387
|
+
recentMessages: Array<{
|
|
388
|
+
id: string;
|
|
389
|
+
timestamp: number;
|
|
390
|
+
sender: string | null;
|
|
391
|
+
hops: number;
|
|
392
|
+
age: number;
|
|
393
|
+
}>;
|
|
394
|
+
connectedPeers: number;
|
|
395
|
+
discoveredPeers: number;
|
|
396
|
+
};
|
|
397
|
+
interface MeshLike {
|
|
398
|
+
on(event: 'peer:data', handler: (data: {
|
|
399
|
+
peerId: string;
|
|
400
|
+
data: any;
|
|
401
|
+
}) => void): void;
|
|
402
|
+
on(event: 'peer:connected' | 'peer:disconnected', handler: (peerId: string) => void): void;
|
|
403
|
+
getClientId(): string | null;
|
|
404
|
+
getConnectedPeers(): string[];
|
|
405
|
+
/** Smoothed round trip of the link to a neighbour, ms; null when not measured yet. */
|
|
406
|
+
getLinkRttMs?(peerId: string): number | null;
|
|
407
|
+
getDiscoveredPeers(): string[];
|
|
408
|
+
getGlobalPeers(): string[];
|
|
409
|
+
getCecrMembershipConfig?(): {
|
|
410
|
+
leaseMs: number;
|
|
411
|
+
gossipIntervalMs: number;
|
|
412
|
+
tombstoneRetentionMs: number;
|
|
413
|
+
clockSkewMs: number;
|
|
414
|
+
};
|
|
415
|
+
getCecrMembershipRecords?(): Array<{
|
|
416
|
+
peerId: string;
|
|
417
|
+
incarnation: number;
|
|
418
|
+
sequence: number;
|
|
419
|
+
state: 'alive' | 'left';
|
|
420
|
+
issuedAt: number;
|
|
421
|
+
validUntil: number | null;
|
|
422
|
+
}>;
|
|
423
|
+
getCecrMembershipEquivocations?(): string[];
|
|
424
|
+
send(peerId: string, data: string | ArrayBuffer | ArrayBufferView): void;
|
|
425
|
+
}
|
|
426
|
+
type GossipEvents = {
|
|
427
|
+
messageReceived: (data: {
|
|
428
|
+
message: GossipMessage;
|
|
429
|
+
local: boolean;
|
|
430
|
+
fromPeer?: string;
|
|
431
|
+
receivedAt: number;
|
|
432
|
+
}) => void;
|
|
433
|
+
peerConnected: (data: {
|
|
434
|
+
peerId: string;
|
|
435
|
+
}) => void;
|
|
436
|
+
peerDisconnected: (data: {
|
|
437
|
+
peerId: string;
|
|
438
|
+
}) => void;
|
|
439
|
+
directMessageReceived: (data: {
|
|
440
|
+
message: DirectMessage;
|
|
441
|
+
}) => void;
|
|
442
|
+
deliveryProgress: (status: GossipDeliveryStatus) => void;
|
|
443
|
+
deliveryComplete: (status: GossipDeliveryStatus) => void;
|
|
444
|
+
deliveryTimeout: (status: GossipDeliveryStatus) => void;
|
|
445
|
+
aggregateProgress: (status: GossipAggregateDeliveryStatus) => void;
|
|
446
|
+
aggregateSettled: (status: GossipAggregateDeliveryStatus) => void;
|
|
447
|
+
cecrStateChanged: (state: CecrStateSnapshot) => void;
|
|
448
|
+
};
|
|
449
|
+
/**
|
|
450
|
+
* GossipProtocol
|
|
451
|
+
*
|
|
452
|
+
* A small, application-level gossip/epidemic message propagation helper.
|
|
453
|
+
*
|
|
454
|
+
* - De-duplicates messages by `id`
|
|
455
|
+
* - Re-broadcasts unseen messages to connected peers until `maxHops`
|
|
456
|
+
* - Repairs missed broadcasts only during their bounded initial CECR spread
|
|
457
|
+
*/
|
|
458
|
+
declare class GossipProtocol {
|
|
459
|
+
private mesh;
|
|
460
|
+
private messageLog;
|
|
461
|
+
private readonly maxTrackedMessages;
|
|
462
|
+
private readonly maxTrackedDirectIds;
|
|
463
|
+
private readonly maxRetainedBytes;
|
|
464
|
+
private readonly maxRetainedMessageBytes;
|
|
465
|
+
private retainedBytes;
|
|
466
|
+
private readonly trackingRetentionMs;
|
|
467
|
+
private antiEntropySummarySize;
|
|
468
|
+
private antiEntropyRequestSize;
|
|
469
|
+
private maxHops;
|
|
470
|
+
private maxDirectHops;
|
|
471
|
+
private cecrCoordinateWeight;
|
|
472
|
+
private cecrExtremaMaxAgeMs;
|
|
473
|
+
private cecrRequireConsensus;
|
|
474
|
+
private cecrConvergenceRounds;
|
|
475
|
+
private cecrViewChangedAtMs;
|
|
476
|
+
private deliveryTimeoutMs;
|
|
477
|
+
private deliveryRepairIntervalMs;
|
|
478
|
+
private cecrCurrentExtrema;
|
|
479
|
+
private cecrRemoteStates;
|
|
480
|
+
private cecrSyncTimer;
|
|
481
|
+
private trackingCleanupTimer;
|
|
482
|
+
private seenDirectIds;
|
|
483
|
+
private learnRoutes;
|
|
484
|
+
private learnedRouteMaxAgeMs;
|
|
485
|
+
private learnedRoutes;
|
|
486
|
+
private routeAckParents;
|
|
487
|
+
private pendingRouteAcks;
|
|
488
|
+
private deliveryStates;
|
|
489
|
+
private aggregateStates;
|
|
490
|
+
private retainedMessages;
|
|
491
|
+
private dirtyDeliveryReceiptIds;
|
|
492
|
+
private gossipFanoutCursor;
|
|
493
|
+
private cecrFanoutCursor;
|
|
494
|
+
private antiEntropyFanoutCursor;
|
|
495
|
+
private initialSpreadRepairQueued;
|
|
496
|
+
private destroyed;
|
|
497
|
+
private callbacks;
|
|
498
|
+
private peers;
|
|
499
|
+
constructor(mesh: MeshLike, options?: GossipProtocolOptions);
|
|
500
|
+
private setupMeshListeners;
|
|
501
|
+
private startCecrSyncLoop;
|
|
502
|
+
private startTrackingCleanupLoop;
|
|
503
|
+
/**
|
|
504
|
+
* Broadcast an application payload using gossip-style re-propagation.
|
|
505
|
+
*/
|
|
506
|
+
broadcast(data: unknown, metadata?: Record<string, unknown>, options?: GossipBroadcastOptions): string;
|
|
507
|
+
/**
|
|
508
|
+
* Broadcast with delivery tracking enabled for the known-peer snapshot.
|
|
509
|
+
*/
|
|
510
|
+
broadcastReliable(data: unknown, metadata?: Record<string, unknown>, options?: Omit<GossipBroadcastOptions, 'trackDelivery'>): string;
|
|
511
|
+
/**
|
|
512
|
+
* Return the sender-visible delivery state for a tracked gossip message.
|
|
513
|
+
*/
|
|
514
|
+
getDeliveryStatus(messageId: string): GossipDeliveryStatus | null;
|
|
515
|
+
/**
|
|
516
|
+
* Propagate to the CECR v1 fan-out budget. Selection rotates over the
|
|
517
|
+
* sorted neighbor set so every eligible connection is chosen fairly.
|
|
518
|
+
*/
|
|
519
|
+
propagate(message: GossipMessage, exceptPeerId?: string): string[];
|
|
520
|
+
/**
|
|
521
|
+
* Handle an incoming message from the mesh.
|
|
522
|
+
*/
|
|
523
|
+
handleIncomingMessage(message: GossipMessage, fromPeerId: string): void;
|
|
524
|
+
private retainGossipMessage;
|
|
525
|
+
private dropRetained;
|
|
526
|
+
/** Bytes of message copies currently held for repair. */
|
|
527
|
+
getRetainedBytes(): number;
|
|
528
|
+
private extendRoutePath;
|
|
529
|
+
private compactRoutePeerId;
|
|
530
|
+
private static readonly INITIAL_SPREAD_REPAIR_MIN_INTERVAL_MS;
|
|
531
|
+
private static readonly MAX_REPLAYS_PER_PEER;
|
|
532
|
+
private static readonly ANTI_ENTROPY_RESEND_MS;
|
|
533
|
+
private readonly lastSummaryByPeer;
|
|
534
|
+
private initialSpreadRepairAtMs;
|
|
535
|
+
private scheduleInitialSpreadRepair;
|
|
536
|
+
private validSpreadEnvelope;
|
|
537
|
+
private initialSpreadDeadlineAt;
|
|
538
|
+
private canContinueInitialSpread;
|
|
539
|
+
private initialSpreadComplete;
|
|
540
|
+
private recentRetainedMessageIds;
|
|
541
|
+
private publishGossipAntiEntropy;
|
|
542
|
+
private handleGossipAntiEntropy;
|
|
543
|
+
private registerAggregateDelivery;
|
|
544
|
+
private refreshAggregateState;
|
|
545
|
+
private aggregateStatusForState;
|
|
546
|
+
/** Return the sender's constant-size reverse aggregate for a broadcast. */
|
|
547
|
+
getAggregateDeliveryStatus(messageId: string): GossipAggregateDeliveryStatus | null;
|
|
548
|
+
private emitAggregateStatus;
|
|
549
|
+
private sendAggregateResponse;
|
|
550
|
+
private publishAggregateState;
|
|
551
|
+
private handleIncomingAggregate;
|
|
552
|
+
private maintainAggregateDeliveries;
|
|
553
|
+
private createDeliveryBits;
|
|
554
|
+
private setDeliveryBit;
|
|
555
|
+
private hasDeliveryBit;
|
|
556
|
+
private deliveryBitsToHex;
|
|
557
|
+
private deliveryBitsFromHex;
|
|
558
|
+
private mergeDeliveryBits;
|
|
559
|
+
private deliveryEnvelopeForState;
|
|
560
|
+
private deliveryReceiptForState;
|
|
561
|
+
private validateDeliveryEnvelope;
|
|
562
|
+
private reconstructDeliveryPeers;
|
|
563
|
+
private registerTrackedDelivery;
|
|
564
|
+
private mergeDeliveryReceipt;
|
|
565
|
+
private deliveryStatusForState;
|
|
566
|
+
private emitDeliveryStatus;
|
|
567
|
+
private selectRepairOwner;
|
|
568
|
+
private maintainTrackedDeliveries;
|
|
569
|
+
private reliableRepairMessage;
|
|
570
|
+
private peerIdToNumeric;
|
|
571
|
+
private canonicalPeerSet;
|
|
572
|
+
private canonicalSetHash;
|
|
573
|
+
private cecrConfigId;
|
|
574
|
+
private cecrFanout;
|
|
575
|
+
private selectFanoutPeers;
|
|
576
|
+
private updateCecrExtremaSnapshot;
|
|
577
|
+
private effectiveCecrCoordinateWeight;
|
|
578
|
+
private hasCecrConsensus;
|
|
579
|
+
private cecrNetworkSizeEstimate;
|
|
580
|
+
private publishCecrState;
|
|
581
|
+
private publishCecrDeliveryState;
|
|
582
|
+
private handleIncomingCecrState;
|
|
583
|
+
private handleIncomingCecrDeliveryState;
|
|
584
|
+
private bucketRank;
|
|
585
|
+
private hybridScore;
|
|
586
|
+
private orderedRouteCandidates;
|
|
587
|
+
private getCecrOverlaySnapshot;
|
|
588
|
+
/**
|
|
589
|
+
* Send a direct message to a specific peer, routed through the mesh via XOR distance.
|
|
590
|
+
* Delivers even if there is no direct connection to the target.
|
|
591
|
+
*/
|
|
592
|
+
/**
|
|
593
|
+
* Whether a direct frame for this peer has somewhere to go right now: the
|
|
594
|
+
* peer is a connected neighbour, or it is in the live membership and at
|
|
595
|
+
* least one neighbour makes XOR progress toward it. Signaling asks this
|
|
596
|
+
* before choosing the mesh over a relay for a negotiation frame.
|
|
597
|
+
*/
|
|
598
|
+
canRouteDirect(targetPeerId: string): boolean;
|
|
599
|
+
/**
|
|
600
|
+
* `connectedOnly` addresses a peer this node is connected to right now, whatever the converged
|
|
601
|
+
* membership view says. The key exchange that runs the moment two peers connect needs it: the
|
|
602
|
+
* view takes a few membership rounds to include a new neighbour, and refusing the frame
|
|
603
|
+
* meant encrypted direct messages waited for the next ten-second announce.
|
|
604
|
+
*/
|
|
605
|
+
sendDirect(targetPeerId: string, data: unknown, options?: {
|
|
606
|
+
connectedOnly?: boolean;
|
|
607
|
+
}): string | null;
|
|
608
|
+
private routeDirect;
|
|
609
|
+
private learnRoute;
|
|
610
|
+
private learnCompactRoute;
|
|
611
|
+
private learnedRouteFor;
|
|
612
|
+
private forgetRoutesVia;
|
|
613
|
+
/** Learned routes, for diagnostics: compact target id -> { via, hops, ageMs }. */
|
|
614
|
+
getLearnedRoutes(): Array<{
|
|
615
|
+
target: string;
|
|
616
|
+
via: string;
|
|
617
|
+
hops: number;
|
|
618
|
+
ageMs: number;
|
|
619
|
+
}>;
|
|
620
|
+
private queueRouteAck;
|
|
621
|
+
private flushRouteAck;
|
|
622
|
+
private handleIncomingRouteAck;
|
|
623
|
+
/**
|
|
624
|
+
* CECR v1.3: how many paths a direct message for a non-neighbour takes.
|
|
625
|
+
* estimatedHops = ceil(log2(estimated network size)) - leading ID bits shared with the target
|
|
626
|
+
* paths = 1 + ceil(log2(1 + estimatedHops)), at least 2, at most `available`
|
|
627
|
+
* A target sharing a longer prefix sits in a smaller part of the ID space,
|
|
628
|
+
* so it is fewer hops away and needs fewer paths.
|
|
629
|
+
*/
|
|
630
|
+
directPathCount(targetPeerId: string, available: number): number;
|
|
631
|
+
/** Neighbours ordered by raw XOR distance to the target (unknown IDs last). */
|
|
632
|
+
private neighboursNearest;
|
|
633
|
+
private handleIncomingDirect;
|
|
634
|
+
getCecrConfig(): Readonly<CecrConfigSnapshot>;
|
|
635
|
+
getCecrState(): CecrStateSnapshot;
|
|
636
|
+
getStats(): GossipStats;
|
|
637
|
+
cleanup(maxAgeMs?: number): void;
|
|
638
|
+
private pruneRouteLearning;
|
|
639
|
+
private markDirectSeen;
|
|
640
|
+
private pruneTracking;
|
|
641
|
+
on<K extends keyof GossipEvents>(event: K, callback: GossipEvents[K]): void;
|
|
642
|
+
off<K extends keyof GossipEvents>(event: K, callback: GossipEvents[K]): void;
|
|
643
|
+
destroy(): void;
|
|
644
|
+
private emit;
|
|
645
|
+
private tryParseGossipMessage;
|
|
646
|
+
private generateMessageId;
|
|
647
|
+
}
|
|
648
|
+
|
|
649
|
+
type RelayKind = 'cloud' | 'local';
|
|
650
|
+
interface RelayInfo {
|
|
651
|
+
url: string;
|
|
652
|
+
nodeId: string;
|
|
653
|
+
kind: RelayKind;
|
|
654
|
+
connections?: number;
|
|
655
|
+
capacity?: number;
|
|
656
|
+
/** True when the relay can only be reached through a tunnel home (no punch). */
|
|
657
|
+
tunnelOnly?: boolean;
|
|
658
|
+
}
|
|
659
|
+
interface RelayMeasurement {
|
|
660
|
+
/** Exponential moving average of connect-to-registered time, ms. */
|
|
661
|
+
joinMs: number | null;
|
|
662
|
+
attempts: number;
|
|
663
|
+
failures: number;
|
|
664
|
+
/** When this was last measured (ms since epoch). */
|
|
665
|
+
at: number;
|
|
666
|
+
}
|
|
667
|
+
declare const RELAY_CANDIDATES = 5;
|
|
668
|
+
declare const RELAY_VIRTUAL_IDS = 4;
|
|
669
|
+
declare const RELAY_SWITCH_MARGIN = 0.3;
|
|
670
|
+
/** The key FreeRTC relays publish a room under. */
|
|
671
|
+
declare function roomRoutingKey(network: string, room: string): Promise<Uint8Array>;
|
|
672
|
+
declare function isHealthy(relay: RelayInfo, m: RelayMeasurement | null | undefined): boolean;
|
|
673
|
+
declare function relayScore(relay: RelayInfo, m: RelayMeasurement | null | undefined): number;
|
|
674
|
+
interface ChooseRelaysOptions {
|
|
675
|
+
peerId: string;
|
|
676
|
+
network: string;
|
|
677
|
+
room: string;
|
|
678
|
+
relays: readonly RelayInfo[];
|
|
679
|
+
measurements?: (nodeId: string) => RelayMeasurement | null | undefined;
|
|
680
|
+
/** The relay URL this peer used last, if any. */
|
|
681
|
+
previousUrl?: string | null;
|
|
682
|
+
candidates?: number;
|
|
683
|
+
virtualIds?: number;
|
|
684
|
+
}
|
|
685
|
+
/** Relay URLs in the order to try them. */
|
|
686
|
+
declare function chooseRelays(options: ChooseRelaysOptions): Promise<string[]>;
|
|
687
|
+
interface SharedRelayScore {
|
|
688
|
+
nodeId: string;
|
|
689
|
+
joinMs: number | null;
|
|
690
|
+
attempts: number;
|
|
691
|
+
failures: number;
|
|
692
|
+
at: number;
|
|
693
|
+
}
|
|
694
|
+
interface StorageLike {
|
|
695
|
+
getItem(key: string): string | null;
|
|
696
|
+
setItem(key: string, value: string): void;
|
|
697
|
+
}
|
|
698
|
+
declare const RELAY_SCORE_STORAGE_KEY = "peerpigeon:relay-scores:v1";
|
|
699
|
+
/**
|
|
700
|
+
* Relay measurements: this peer's own joins, and what other peers share.
|
|
701
|
+
* Kept in localStorage when there is one, so a returning peer goes straight
|
|
702
|
+
* to the relay that worked last time.
|
|
703
|
+
*/
|
|
704
|
+
declare class RelayScoreBook {
|
|
705
|
+
private entries;
|
|
706
|
+
private storage;
|
|
707
|
+
private now;
|
|
708
|
+
constructor(options?: {
|
|
709
|
+
storage?: StorageLike | null;
|
|
710
|
+
now?: () => number;
|
|
711
|
+
});
|
|
712
|
+
static defaultStorage(): StorageLike | null;
|
|
713
|
+
private entry;
|
|
714
|
+
/** Record one of this peer's own joins through a relay. */
|
|
715
|
+
recordJoin(nodeId: string, result: {
|
|
716
|
+
ok: boolean;
|
|
717
|
+
joinMs?: number | null;
|
|
718
|
+
}): void;
|
|
719
|
+
/** Merge scores another peer shared. Only its own measurements, one set per source. */
|
|
720
|
+
mergeShared(sourcePeerId: string, scores: readonly SharedRelayScore[]): void;
|
|
721
|
+
/** The combined measurement for a relay, own counted OWN_WEIGHT times. */
|
|
722
|
+
measurement(nodeId: string): RelayMeasurement | null;
|
|
723
|
+
/** This peer's own measurements, to share with others. */
|
|
724
|
+
ownScores(limit?: number): SharedRelayScore[];
|
|
725
|
+
private load;
|
|
726
|
+
private save;
|
|
727
|
+
}
|
|
728
|
+
|
|
729
|
+
type StorageSpace = 'public' | 'user' | 'frozen' | 'private' | 'epublic';
|
|
730
|
+
type StorageVersion = string | number;
|
|
731
|
+
type StorageChangeOrigin = 'local' | 'remote';
|
|
732
|
+
interface StorageRecord<T = unknown> {
|
|
733
|
+
space: StorageSpace;
|
|
734
|
+
key: string;
|
|
735
|
+
value: T;
|
|
736
|
+
ownerId: string | null;
|
|
737
|
+
/** Mesh peer ID that most recently changed this record. */
|
|
738
|
+
modifiedBy: string | null;
|
|
739
|
+
/**
|
|
740
|
+
* The key that signed this record (checked before it was taken), with signed storage.
|
|
741
|
+
* For a frozen record it is who wrote it: an account's key, when it was written after signAs.
|
|
742
|
+
*/
|
|
743
|
+
signer?: string | null;
|
|
744
|
+
createdAt: number;
|
|
745
|
+
updatedAt: number;
|
|
746
|
+
version: StorageVersion;
|
|
747
|
+
}
|
|
748
|
+
interface StoragePutOptions {
|
|
749
|
+
/**
|
|
750
|
+
* Override owner for first write in user-space records.
|
|
751
|
+
*/
|
|
752
|
+
ownerId?: string;
|
|
753
|
+
/**
|
|
754
|
+
* Store the record and serve it on request, but announce nothing: no
|
|
755
|
+
* mutation is gossiped to the room. For content-addressed records that
|
|
756
|
+
* nobody subscribes to in advance — a watcher re-seeding every chunk of
|
|
757
|
+
* every snapshot at start gossiped each one to every peer in the room,
|
|
758
|
+
* hundreds of megabytes that no peer had asked for.
|
|
759
|
+
*/
|
|
760
|
+
silent?: boolean;
|
|
761
|
+
}
|
|
762
|
+
interface StorageSyncOptions {
|
|
763
|
+
/**
|
|
764
|
+
* Shared room scope used to derive sync encryption keys.
|
|
765
|
+
*/
|
|
766
|
+
sessionId?: string;
|
|
767
|
+
/**
|
|
768
|
+
* Optional secret mixed into key derivation for stronger room privacy.
|
|
769
|
+
*/
|
|
770
|
+
syncSecret?: string;
|
|
771
|
+
}
|
|
772
|
+
interface StorageRetrieveOptions {
|
|
773
|
+
timeoutMs?: number;
|
|
774
|
+
}
|
|
775
|
+
interface StorageSyncFilterContext {
|
|
776
|
+
kind: 'mutation' | 'retrieve-request' | 'retrieve-response';
|
|
777
|
+
actorId: string;
|
|
778
|
+
}
|
|
779
|
+
interface StorageOptions extends StorageSyncOptions {
|
|
780
|
+
/**
|
|
781
|
+
* Local user identity used by ACL checks.
|
|
782
|
+
*/
|
|
783
|
+
userId: string;
|
|
784
|
+
/** Local mesh peer ID recorded as modification provenance. */
|
|
785
|
+
peerId?: string;
|
|
786
|
+
/**
|
|
787
|
+
* Optional mesh gossip helper.
|
|
788
|
+
*/
|
|
789
|
+
gossip?: GossipLike;
|
|
790
|
+
/**
|
|
791
|
+
* Optional IndexedDB name (default: peerpigeon-storage-v1).
|
|
792
|
+
*/
|
|
793
|
+
dbName?: string;
|
|
794
|
+
/**
|
|
795
|
+
* Optional local gate for remote sync payloads.
|
|
796
|
+
* Returning false drops remote storage updates for the given key.
|
|
797
|
+
*/
|
|
798
|
+
syncFilter?: (space: StorageSpace, key: string, context: StorageSyncFilterContext) => boolean;
|
|
799
|
+
/**
|
|
800
|
+
* Key prefixes this node replicates in full (public and user spaces): it
|
|
801
|
+
* keeps every change to a key under them without subscribing to the key,
|
|
802
|
+
* and a neighbour that links up sends it every such record it holds (not
|
|
803
|
+
* only the keys this node already knew of), so a newcomer has the whole
|
|
804
|
+
* namespace at once.
|
|
805
|
+
*/
|
|
806
|
+
replicate?: string[];
|
|
807
|
+
/**
|
|
808
|
+
* With storage servers: once the room's servers hold a record, drop the
|
|
809
|
+
* local copy unless this node uses it (subscribed, replicated, private),
|
|
810
|
+
* and read it from the servers when asked. Default: true.
|
|
811
|
+
*/
|
|
812
|
+
moveToServers?: boolean;
|
|
813
|
+
/**
|
|
814
|
+
* With storage servers: how long a read of a record not kept here waits for
|
|
815
|
+
* the room's servers to be linked, right after joining (ms). Default 8000.
|
|
816
|
+
* Once they are linked, or the wait has run out once, reads do not wait.
|
|
817
|
+
*/
|
|
818
|
+
serverWaitMs?: number;
|
|
819
|
+
/**
|
|
820
|
+
* A room of one key's own (a person's records): on the storage servers it takes only records
|
|
821
|
+
* that key signs, so nobody else can put anything in it. Writes here must be signed by it
|
|
822
|
+
* (signingKeys, or signAs). Give the room a sessionId of its own too.
|
|
823
|
+
*/
|
|
824
|
+
owner?: string;
|
|
825
|
+
/**
|
|
826
|
+
* Signs every change this node makes, and accepts only signed changes from
|
|
827
|
+
* others: a record's signer is who made it, and a user record's owner is
|
|
828
|
+
* its signer's key (its ownerId). PeerPigeonNode passes its key pair.
|
|
829
|
+
*/
|
|
830
|
+
signingKeys?: {
|
|
831
|
+
pub: string;
|
|
832
|
+
priv: string;
|
|
833
|
+
} | null;
|
|
834
|
+
}
|
|
835
|
+
type StorageEvents = {
|
|
836
|
+
change: (event: {
|
|
837
|
+
origin: StorageChangeOrigin;
|
|
838
|
+
op: 'upsert' | 'delete';
|
|
839
|
+
record: StorageRecord | null;
|
|
840
|
+
space: StorageSpace;
|
|
841
|
+
key: string;
|
|
842
|
+
actorId: string;
|
|
843
|
+
}) => void;
|
|
844
|
+
};
|
|
845
|
+
type StorageUnsubscribe = () => void;
|
|
846
|
+
type GossipMessageListener = (data: {
|
|
847
|
+
message: {
|
|
848
|
+
data: unknown;
|
|
849
|
+
};
|
|
850
|
+
local: boolean;
|
|
851
|
+
fromPeer?: string;
|
|
852
|
+
}) => void;
|
|
853
|
+
type GossipDirectListener = (data: {
|
|
854
|
+
message: {
|
|
855
|
+
data: unknown;
|
|
856
|
+
from?: string;
|
|
857
|
+
};
|
|
858
|
+
}) => void;
|
|
859
|
+
type GossipPeerListener = (data: {
|
|
860
|
+
peerId: string;
|
|
861
|
+
}) => void;
|
|
862
|
+
interface GossipLike {
|
|
863
|
+
broadcast(data: unknown, metadata?: Record<string, unknown>): string;
|
|
864
|
+
sendDirect?(targetPeerId: string, data: unknown): string | null;
|
|
865
|
+
on(event: 'messageReceived', callback: GossipMessageListener): void;
|
|
866
|
+
on(event: 'directMessageReceived', callback: GossipDirectListener): void;
|
|
867
|
+
on(event: 'peerConnected', callback: GossipPeerListener): void;
|
|
868
|
+
off(event: 'messageReceived', callback: GossipMessageListener): void;
|
|
869
|
+
off(event: 'directMessageReceived', callback: GossipDirectListener): void;
|
|
870
|
+
off(event: 'peerConnected', callback: GossipPeerListener): void;
|
|
871
|
+
}
|
|
872
|
+
declare class PeerPigeonStorage {
|
|
873
|
+
private readonly userId;
|
|
874
|
+
private peerId;
|
|
875
|
+
private readonly gossip;
|
|
876
|
+
private readonly sessionId;
|
|
877
|
+
private readonly syncSecret;
|
|
878
|
+
private readonly dbName;
|
|
879
|
+
private readonly syncFilter;
|
|
880
|
+
private readonly replicate;
|
|
881
|
+
private readonly storeName;
|
|
882
|
+
private driver;
|
|
883
|
+
private readonly listeners;
|
|
884
|
+
private readonly subscribedKeys;
|
|
885
|
+
private readonly subscribedEntries;
|
|
886
|
+
private readonly onDirectMessageBound;
|
|
887
|
+
private readonly onPeerConnectedBound;
|
|
888
|
+
private readonly retrieveAnsweredAt;
|
|
889
|
+
private readonly retrieveAnswerTimes;
|
|
890
|
+
private readonly pendingRetrieveRequests;
|
|
891
|
+
private closed;
|
|
892
|
+
private readonly moveToServers;
|
|
893
|
+
private signingKeys;
|
|
894
|
+
private readonly ownSigningKeys;
|
|
895
|
+
private servers;
|
|
896
|
+
private serverIds;
|
|
897
|
+
private serversReady;
|
|
898
|
+
private readonly serverWaitMs;
|
|
899
|
+
private readonly owner;
|
|
900
|
+
private serversWait;
|
|
901
|
+
private serversWaitDone;
|
|
902
|
+
private migrating;
|
|
903
|
+
private readonly onGossipMessageBound;
|
|
904
|
+
private readonly instanceId;
|
|
905
|
+
private crossTabChannel;
|
|
906
|
+
private readonly crossTabSeenNoticeIds;
|
|
907
|
+
private readonly crossTabStorageEventBound;
|
|
908
|
+
private readonly crossTabChannelMessageBound;
|
|
909
|
+
constructor(options: StorageOptions);
|
|
910
|
+
init(): Promise<void>;
|
|
911
|
+
on(event: 'change', listener: StorageEvents['change']): void;
|
|
912
|
+
subscribe(listener: StorageEvents['change']): StorageUnsubscribe;
|
|
913
|
+
/** Subscribe to remote updates for one exact storage-space/key pair. */
|
|
914
|
+
subscribeKey(space: StorageSpace, key: string): StorageUnsubscribe;
|
|
915
|
+
/** Stop accepting remote updates for one exact storage-space/key pair. */
|
|
916
|
+
unsubscribeKey(space: StorageSpace, key: string): void;
|
|
917
|
+
/** Return whether this instance accepts remote updates for a key. */
|
|
918
|
+
isSubscribed(space: StorageSpace, key: string): boolean;
|
|
919
|
+
/** Update the mesh peer ID recorded on subsequent local mutations. */
|
|
920
|
+
setPeerId(peerId: string): void;
|
|
921
|
+
off(event: 'change', listener: StorageEvents['change']): void;
|
|
922
|
+
put<T = unknown>(space: StorageSpace, key: string, value: T, options?: StoragePutOptions): Promise<StorageRecord<T>>;
|
|
923
|
+
putSystem<T = unknown>(space: StorageSpace, key: string, value: T, options?: StoragePutOptions): Promise<StorageRecord<T>>;
|
|
924
|
+
get<T = unknown>(space: StorageSpace, key: string): Promise<StorageRecord<T> | null>;
|
|
925
|
+
retrieve<T = unknown>(space: StorageSpace, key: string, options?: StorageRetrieveOptions): Promise<StorageRecord<T> | null>;
|
|
926
|
+
/** How long to wait for a Get's answer: twice the slowest recent answer, within bounds. */
|
|
927
|
+
private expectedAnswerMs;
|
|
928
|
+
private noteAnswerTime;
|
|
929
|
+
delete(space: StorageSpace, key: string): Promise<boolean>;
|
|
930
|
+
deleteSystem(space: StorageSpace, key: string): Promise<boolean>;
|
|
931
|
+
list(space: StorageSpace): Promise<StorageRecord[]>;
|
|
932
|
+
close(): Promise<void>;
|
|
933
|
+
/** Who this node acts as in a space: its signing key when it signs (a user record's owner), else its user id. */
|
|
934
|
+
private actorFor;
|
|
935
|
+
/** The id records this node owns carry: its signing key when it signs, else its user id. */
|
|
936
|
+
ownerIdentity(): string;
|
|
937
|
+
/** What a signature covers: everything a record says, but where it is kept. */
|
|
938
|
+
private signedText;
|
|
939
|
+
/** The key that signed a change, if its signature holds (and an upsert's time is its record's); else null. */
|
|
940
|
+
private verifiedSigner;
|
|
941
|
+
/**
|
|
942
|
+
* Uses storage servers (a link from storage-servers.ts) for this room: its
|
|
943
|
+
* records go to the room's closest servers, the ones already here are moved
|
|
944
|
+
* to them once they are there, and changes others make arrive from them.
|
|
945
|
+
*/
|
|
946
|
+
attachServers(link: StorageServerLink): Promise<void>;
|
|
947
|
+
/**
|
|
948
|
+
* Sign this peer's changes as an account from now on: its keys (after the
|
|
949
|
+
* person signs in), so what they write is theirs on every device they sign
|
|
950
|
+
* in from. null goes back to the keys this storage started with (signing out).
|
|
951
|
+
*/
|
|
952
|
+
signAs(keys: {
|
|
953
|
+
pub: string;
|
|
954
|
+
priv: string;
|
|
955
|
+
} | null): void;
|
|
956
|
+
/** Who signs this peer's changes now (an account's key after signAs), or null when unsigned. */
|
|
957
|
+
signer(): string | null;
|
|
958
|
+
/**
|
|
959
|
+
* Storage servers are on their way (the node is linking to them): until they
|
|
960
|
+
* are linked, or serverWaitMs has passed, a read of a record not kept here
|
|
961
|
+
* waits for them rather than finding nothing. A peer that comes back to a
|
|
962
|
+
* room where no other peer is online reads what it left on the servers.
|
|
963
|
+
*/
|
|
964
|
+
expectServers(): void;
|
|
965
|
+
/** Whether the room's servers are linked, after waiting for them right after joining. */
|
|
966
|
+
private serversLinked;
|
|
967
|
+
/**
|
|
968
|
+
* Whether the room's servers are linked, as the link has it now. Asked each time rather than
|
|
969
|
+
* kept from the link's events, so a storage never goes on believing there are none.
|
|
970
|
+
*/
|
|
971
|
+
private serversUp;
|
|
972
|
+
/** Whether the room's servers are linked now, and how many. */
|
|
973
|
+
serverCount(): number;
|
|
974
|
+
private slotOf;
|
|
975
|
+
/** Sends one change to the room's servers; resolves with how many took it. */
|
|
976
|
+
private pushToServers;
|
|
977
|
+
/** A record from a server: decrypted, checked like any change from the mesh, and kept here. */
|
|
978
|
+
private applyServerRecord;
|
|
979
|
+
private readFromServers;
|
|
980
|
+
/** The records of a space the room's servers keep, decrypted (not kept here). */
|
|
981
|
+
private listFromServers;
|
|
982
|
+
/**
|
|
983
|
+
* The room's servers came up: everything kept here (but private) goes to
|
|
984
|
+
* them, and, once they hold it, what this node does not use is dropped here.
|
|
985
|
+
*/
|
|
986
|
+
private migrateToServers;
|
|
987
|
+
/** Whether this node keeps a record here even when servers hold it: one it subscribes to or replicates. */
|
|
988
|
+
private usesLocally;
|
|
989
|
+
private applyLocalUpsert;
|
|
990
|
+
private applyLocalDelete;
|
|
991
|
+
private handleGossipMessage;
|
|
992
|
+
private applyRemoteMutation;
|
|
993
|
+
private setupCrossTabSync;
|
|
994
|
+
private teardownCrossTabSync;
|
|
995
|
+
private crossTabChannelName;
|
|
996
|
+
private crossTabStorageKey;
|
|
997
|
+
private publishCrossTabNotice;
|
|
998
|
+
private handleCrossTabChannelMessage;
|
|
999
|
+
private handleCrossTabStorageEvent;
|
|
1000
|
+
private consumeCrossTabNotice;
|
|
1001
|
+
private applyCrossTabNotice;
|
|
1002
|
+
private trimSeenNoticeIds;
|
|
1003
|
+
private broadcastMutation;
|
|
1004
|
+
private syncEnvelope;
|
|
1005
|
+
private broadcastSyncPayload;
|
|
1006
|
+
private handleRetrieveRequest;
|
|
1007
|
+
private handleRetrieveResponse;
|
|
1008
|
+
/** The configured filter's verdict, or null when there is no filter. */
|
|
1009
|
+
private syncFilterAccepts;
|
|
1010
|
+
/**
|
|
1011
|
+
* Whether an arriving mutation, response or request concerns this node.
|
|
1012
|
+
*
|
|
1013
|
+
* A syncFilter names the namespace this node replicates, and it used to be
|
|
1014
|
+
* consulted only AFTER a check that the exact key was already subscribed —
|
|
1015
|
+
* so it could never bring anything in, only keep things out. A node that
|
|
1016
|
+
* had subscribed to nothing dropped every mutation for its own namespace:
|
|
1017
|
+
* it heard the room say a record had changed and threw the words away.
|
|
1018
|
+
*
|
|
1019
|
+
* That made a subscription the only way to learn anything, and a peer with
|
|
1020
|
+
* none was unreachable by the room. It sent an empty digest, so nothing was
|
|
1021
|
+
* pushed to it, and every mutation it heard was discarded — silence that
|
|
1022
|
+
* looked exactly like an empty room. A watcher publishing every ten seconds
|
|
1023
|
+
* was invisible to a peer sitting next to it.
|
|
1024
|
+
*
|
|
1025
|
+
* So a node that declares a namespace replicates it. A node that declares
|
|
1026
|
+
* none keeps the old rule and takes only what it subscribed to, which is
|
|
1027
|
+
* what stops a filterless node from accepting the whole room.
|
|
1028
|
+
*/
|
|
1029
|
+
private shouldAcceptRemoteSync;
|
|
1030
|
+
private createDriver;
|
|
1031
|
+
private emitChange;
|
|
1032
|
+
private requireDriver;
|
|
1033
|
+
private normalizeKey;
|
|
1034
|
+
private makePk;
|
|
1035
|
+
/**
|
|
1036
|
+
* Whether a request or digest is this node's own. By mesh peer id when both
|
|
1037
|
+
* sides have one: two tabs (or devices) of the same person share an identity,
|
|
1038
|
+
* and each must still answer the other.
|
|
1039
|
+
*/
|
|
1040
|
+
private fromSelf;
|
|
1041
|
+
private makeMutationId;
|
|
1042
|
+
private parseStorageVersion;
|
|
1043
|
+
private versionSourceToken;
|
|
1044
|
+
private normalizeStorageVersion;
|
|
1045
|
+
private compareStorageVersions;
|
|
1046
|
+
private nextStorageVersion;
|
|
1047
|
+
private resolveOwnerId;
|
|
1048
|
+
private assertCanWrite;
|
|
1049
|
+
private canWrite;
|
|
1050
|
+
private isPeerIdFormat;
|
|
1051
|
+
private assertCanDelete;
|
|
1052
|
+
private canDelete;
|
|
1053
|
+
private encodeValueForStore;
|
|
1054
|
+
private decodeValueForRead;
|
|
1055
|
+
private isSyncEnvelope;
|
|
1056
|
+
private isStorageMutation;
|
|
1057
|
+
private isStorageRetrieveRequest;
|
|
1058
|
+
private isStorageRetrieveResponse;
|
|
1059
|
+
private isStorageDigest;
|
|
1060
|
+
/**
|
|
1061
|
+
* Tell a neighbour that just linked up which mutable records this node
|
|
1062
|
+
* subscribes to and which version of each it holds. Frozen records are
|
|
1063
|
+
* content-addressed and fetched on demand, so they stay out of it.
|
|
1064
|
+
*/
|
|
1065
|
+
private sendDigest;
|
|
1066
|
+
/**
|
|
1067
|
+
* Answer a neighbour's digest: push every record this node holds newer
|
|
1068
|
+
* than the version listed, and ask directly for every subscribed record
|
|
1069
|
+
* the neighbour holds newer than ours.
|
|
1070
|
+
*/
|
|
1071
|
+
private handleDigest;
|
|
1072
|
+
/** Whether this node replicates a key in full (a `replicate` prefix). */
|
|
1073
|
+
private replicates;
|
|
1074
|
+
private isCrossTabNotice;
|
|
1075
|
+
private isCipherPayload;
|
|
1076
|
+
private encryptSyncPayload;
|
|
1077
|
+
private decryptSyncEnvelope;
|
|
1078
|
+
private encryptPrivateValue;
|
|
1079
|
+
private decryptPrivateValue;
|
|
1080
|
+
private deriveAesKey;
|
|
1081
|
+
private encryptJson;
|
|
1082
|
+
private decryptJson;
|
|
1083
|
+
private toBase64Url;
|
|
1084
|
+
private fromBase64Url;
|
|
1085
|
+
}
|
|
1086
|
+
|
|
1087
|
+
declare const ENCRYPTED_BROADCAST_TYPE = "pp-encrypted-broadcast-v1";
|
|
1088
|
+
declare const ENCRYPTED_DIRECT_TYPE = "pp-encrypted-direct-v1";
|
|
1089
|
+
type PeerPigeonKeyPair = {
|
|
1090
|
+
pub: string;
|
|
1091
|
+
priv: string;
|
|
1092
|
+
epub: string;
|
|
1093
|
+
epriv: string;
|
|
1094
|
+
qpub?: string;
|
|
1095
|
+
qpriv?: string;
|
|
1096
|
+
kpub?: string;
|
|
1097
|
+
kpriv?: string;
|
|
1098
|
+
};
|
|
1099
|
+
type PeerPublicKey = {
|
|
1100
|
+
peerId: string;
|
|
1101
|
+
pub: string;
|
|
1102
|
+
epub: string;
|
|
1103
|
+
/** ML-KEM-768 public key, when the peer has one. */
|
|
1104
|
+
kpub?: string;
|
|
1105
|
+
updatedAt: number;
|
|
1106
|
+
local: boolean;
|
|
1107
|
+
};
|
|
1108
|
+
type RoomCipher = {
|
|
1109
|
+
alg: 'A256GCM';
|
|
1110
|
+
iv: string;
|
|
1111
|
+
ct: string;
|
|
1112
|
+
};
|
|
1113
|
+
type EncryptedBroadcastPayload = {
|
|
1114
|
+
__ppType: typeof ENCRYPTED_BROADCAST_TYPE;
|
|
1115
|
+
from: string;
|
|
1116
|
+
roomCipher: RoomCipher;
|
|
1117
|
+
timestamp: number;
|
|
1118
|
+
};
|
|
1119
|
+
type EncryptedDirectPayload = {
|
|
1120
|
+
__ppType: typeof ENCRYPTED_DIRECT_TYPE;
|
|
1121
|
+
from: string;
|
|
1122
|
+
to: string;
|
|
1123
|
+
cipher: unknown;
|
|
1124
|
+
timestamp: number;
|
|
1125
|
+
};
|
|
1126
|
+
type PeerPigeonCryptoOptions = {
|
|
1127
|
+
/** Room scope mixed into the AES-GCM room key. */
|
|
1128
|
+
roomId: string;
|
|
1129
|
+
/** Optional shared secret mixed into the room key. */
|
|
1130
|
+
roomSecret?: string;
|
|
1131
|
+
/** Supply an identity (from exportIdentity() on another device) instead of the one kept here. */
|
|
1132
|
+
keyPair?: PeerPigeonKeyPair;
|
|
1133
|
+
/**
|
|
1134
|
+
* Where the identity is kept, so a peer is the same person when it comes back:
|
|
1135
|
+
* 'local' (or true, the default) keeps it in localStorage, for every tab and
|
|
1136
|
+
* visit of this browser; 'session' keeps it for this tab only; false keeps none.
|
|
1137
|
+
* The records a peer owns (its user space, its private space) stay its own
|
|
1138
|
+
* only while it keeps this identity.
|
|
1139
|
+
*/
|
|
1140
|
+
persistKeyPair?: boolean | 'local' | 'session';
|
|
1141
|
+
/** Storage key prefix for the kept identity. */
|
|
1142
|
+
storageKey?: string;
|
|
1143
|
+
/** Key advertisement interval. Default 10 seconds; 0 disables it. */
|
|
1144
|
+
announceIntervalMs?: number;
|
|
1145
|
+
/** Default wait for direct-message key discovery. Default 8 seconds. */
|
|
1146
|
+
keyDiscoveryTimeoutMs?: number;
|
|
1147
|
+
};
|
|
1148
|
+
type PeerPigeonCryptoEvents = {
|
|
1149
|
+
keyDiscovered: (key: PeerPublicKey) => void;
|
|
1150
|
+
encryptedBroadcastReceived: (data: {
|
|
1151
|
+
plaintext: string;
|
|
1152
|
+
payload: EncryptedBroadcastPayload;
|
|
1153
|
+
message: GossipMessage;
|
|
1154
|
+
local: boolean;
|
|
1155
|
+
fromPeer?: string;
|
|
1156
|
+
receivedAt: number;
|
|
1157
|
+
}) => void;
|
|
1158
|
+
encryptedDirectReceived: (data: {
|
|
1159
|
+
plaintext: string;
|
|
1160
|
+
payload: EncryptedDirectPayload;
|
|
1161
|
+
message: DirectMessage;
|
|
1162
|
+
}) => void;
|
|
1163
|
+
error: (error: Error) => void;
|
|
1164
|
+
};
|
|
1165
|
+
interface CryptoMeshLike {
|
|
1166
|
+
on(event: 'peer:connected', handler: (peerId: string) => void): void;
|
|
1167
|
+
on(event: 'signaling:connected', handler: (data: {
|
|
1168
|
+
clientId: string;
|
|
1169
|
+
}) => void): void;
|
|
1170
|
+
off(event: 'peer:connected', handler: (peerId: string) => void): void;
|
|
1171
|
+
off(event: 'signaling:connected', handler: (data: {
|
|
1172
|
+
clientId: string;
|
|
1173
|
+
}) => void): void;
|
|
1174
|
+
getClientId(): string | null;
|
|
1175
|
+
getConnectedPeers(): string[];
|
|
1176
|
+
}
|
|
1177
|
+
interface CryptoGossipLike {
|
|
1178
|
+
broadcast(data: unknown, metadata?: Record<string, unknown>, options?: GossipBroadcastOptions): string;
|
|
1179
|
+
broadcastReliable(data: unknown, metadata?: Record<string, unknown>, options?: Omit<GossipBroadcastOptions, 'trackDelivery'>): string;
|
|
1180
|
+
sendDirect(targetPeerId: string, data: unknown, options?: {
|
|
1181
|
+
connectedOnly?: boolean;
|
|
1182
|
+
}): string | null;
|
|
1183
|
+
on(event: 'messageReceived', callback: (data: {
|
|
1184
|
+
message: GossipMessage;
|
|
1185
|
+
local: boolean;
|
|
1186
|
+
fromPeer?: string;
|
|
1187
|
+
receivedAt?: number;
|
|
1188
|
+
}) => void): void;
|
|
1189
|
+
on(event: 'directMessageReceived', callback: (data: {
|
|
1190
|
+
message: DirectMessage;
|
|
1191
|
+
}) => void): void;
|
|
1192
|
+
off(event: 'messageReceived', callback: (data: {
|
|
1193
|
+
message: GossipMessage;
|
|
1194
|
+
local: boolean;
|
|
1195
|
+
fromPeer?: string;
|
|
1196
|
+
receivedAt?: number;
|
|
1197
|
+
}) => void): void;
|
|
1198
|
+
off(event: 'directMessageReceived', callback: (data: {
|
|
1199
|
+
message: DirectMessage;
|
|
1200
|
+
}) => void): void;
|
|
1201
|
+
}
|
|
1202
|
+
declare class PeerPigeonCryptoProtocol {
|
|
1203
|
+
private readonly mesh;
|
|
1204
|
+
private readonly gossip;
|
|
1205
|
+
private readonly options;
|
|
1206
|
+
private keyPair;
|
|
1207
|
+
private readonly publicKeys;
|
|
1208
|
+
private readonly callbacks;
|
|
1209
|
+
private announceTimer;
|
|
1210
|
+
private initialized;
|
|
1211
|
+
/** Broadcasts seen for other rooms, counted rather than reported as errors. */
|
|
1212
|
+
private foreignBroadcasts;
|
|
1213
|
+
private readonly onGossipMessageBound;
|
|
1214
|
+
private readonly onDirectMessageBound;
|
|
1215
|
+
private readonly keyExchangeTimers;
|
|
1216
|
+
private readonly onPeerConnectedBound;
|
|
1217
|
+
private readonly onSignalingConnectedBound;
|
|
1218
|
+
constructor(mesh: CryptoMeshLike, gossip: CryptoGossipLike, options: PeerPigeonCryptoOptions);
|
|
1219
|
+
init(): Promise<void>;
|
|
1220
|
+
getKeyPair(): Readonly<PeerPigeonKeyPair>;
|
|
1221
|
+
getPublicKey(peerId: string): PeerPublicKey | null;
|
|
1222
|
+
/** How many broadcasts this node has seen for rooms it is not in. */
|
|
1223
|
+
getForeignBroadcastCount(): number;
|
|
1224
|
+
getKnownPeerKeys(): PeerPublicKey[];
|
|
1225
|
+
announcePublicKey(): void;
|
|
1226
|
+
private readonly keyRequestedAt;
|
|
1227
|
+
requestPeerKey(peerId: string): void;
|
|
1228
|
+
waitForPeerKey(peerId: string, timeoutMs?: number): Promise<PeerPublicKey>;
|
|
1229
|
+
encryptRoom(plaintext: string): Promise<RoomCipher>;
|
|
1230
|
+
decryptRoom(cipher: RoomCipher): Promise<string>;
|
|
1231
|
+
createEncryptedBroadcast(plaintext: string): Promise<EncryptedBroadcastPayload>;
|
|
1232
|
+
createEncryptedDirect(peerId: string, plaintext: string, timeoutMs?: number): Promise<EncryptedDirectPayload>;
|
|
1233
|
+
broadcastEncrypted(plaintext: string, metadata?: Record<string, unknown>, options?: GossipBroadcastOptions): Promise<string>;
|
|
1234
|
+
sendEncryptedDirect(peerId: string, plaintext: string, timeoutMs?: number): Promise<string>;
|
|
1235
|
+
decryptEncryptedBroadcast(payload: EncryptedBroadcastPayload): Promise<string>;
|
|
1236
|
+
decryptEncryptedDirect(payload: EncryptedDirectPayload): Promise<string>;
|
|
1237
|
+
on<K extends keyof PeerPigeonCryptoEvents>(event: K, callback: PeerPigeonCryptoEvents[K]): void;
|
|
1238
|
+
off<K extends keyof PeerPigeonCryptoEvents>(event: K, callback: PeerPigeonCryptoEvents[K]): void;
|
|
1239
|
+
destroy(): void;
|
|
1240
|
+
static isProtocolPayload(value: unknown): boolean;
|
|
1241
|
+
private validateKeyPair;
|
|
1242
|
+
private keyStores;
|
|
1243
|
+
private loadStoredKeyPair;
|
|
1244
|
+
private persistKeyPair;
|
|
1245
|
+
private registerLocalKey;
|
|
1246
|
+
private localPublicInfoPayload;
|
|
1247
|
+
/** True when the neighbour took the frame. A neighbour is addressed whatever the membership view says. */
|
|
1248
|
+
private sendPublicInfoDirect;
|
|
1249
|
+
/**
|
|
1250
|
+
* Swap keys with a peer that has just connected, and keep trying while it is still connected and
|
|
1251
|
+
* either the frame was refused or its key has not arrived. The periodic announce stays as the backstop.
|
|
1252
|
+
*/
|
|
1253
|
+
private exchangeKeysWithNeighbour;
|
|
1254
|
+
private upsertPublicKey;
|
|
1255
|
+
private isPublicInfo;
|
|
1256
|
+
private isPublicRequest;
|
|
1257
|
+
private isEncryptedBroadcast;
|
|
1258
|
+
private isEncryptedDirect;
|
|
1259
|
+
private handleGossipMessage;
|
|
1260
|
+
private handleDirectMessage;
|
|
1261
|
+
private deriveRoomKey;
|
|
1262
|
+
private cryptoApi;
|
|
1263
|
+
private toBase64Url;
|
|
1264
|
+
private fromBase64Url;
|
|
1265
|
+
private emitError;
|
|
1266
|
+
private emit;
|
|
1267
|
+
}
|
|
1268
|
+
|
|
1269
|
+
/** Deterministic SHA-1 hex for compact, non-routing public display IDs. */
|
|
1270
|
+
declare function sha1Hex(value: unknown): string;
|
|
1271
|
+
|
|
1272
|
+
/** Payload type of a signaling envelope carried inside a gossip direct frame. */
|
|
1273
|
+
declare const MESH_SIGNAL_PAYLOAD_TYPE = "pp-signal-v1";
|
|
1274
|
+
declare function isMeshSignalPayload(value: unknown): value is {
|
|
1275
|
+
__ppType: typeof MESH_SIGNAL_PAYLOAD_TYPE;
|
|
1276
|
+
envelope: Record<string, unknown>;
|
|
1277
|
+
};
|
|
1278
|
+
|
|
1279
|
+
declare const DEFAULT_SIGNALING_SERVERS: readonly string[];
|
|
1280
|
+
declare const DEFAULT_CLOSE_SIGNALING_RELAY_COUNT = 4;
|
|
1281
|
+
declare const NEGOTIATION_DEAD_TRANSPORT_DEADLINE_MS = 4000;
|
|
1282
|
+
declare const NEGOTIATION_ACTIVE_ICE_DEADLINE_MS = 6000;
|
|
1283
|
+
declare const NEGOTIATION_OFFER_DEADLINE_MS = 20000;
|
|
1284
|
+
/**
|
|
1285
|
+
* Whether this runtime can open a direct (WebRTC Direct) relay connection.
|
|
1286
|
+
* Opened in Chromium, Node and Safari (27, 2026-10-31: the channel opens in
|
|
1287
|
+
* about 0.6 s); Firefox is untested, so it keeps using the other relays.
|
|
1288
|
+
*/
|
|
1289
|
+
declare function directRelaySupported(): boolean;
|
|
1290
|
+
/** A relay to rank: its URL, and its FreeRTC node ID when known. */
|
|
1291
|
+
type SignalingRelayCandidate = string | {
|
|
1292
|
+
url: string;
|
|
1293
|
+
nodeId?: string | null;
|
|
1294
|
+
node_id?: string | null;
|
|
1295
|
+
};
|
|
1296
|
+
/** Order relays by node-ID XOR distance to the peer ID (SHA-256(hostname) when a relay's node ID is unknown). */
|
|
1297
|
+
declare function rankSignalingServersByDistance(peerId: string, relays: readonly SignalingRelayCandidate[]): Promise<string[]>;
|
|
1298
|
+
/** Choose exactly one relay by node-ID XOR distance to the peer ID. */
|
|
1299
|
+
declare function selectClosestSignalingServer(peerId: string, relayUrls: readonly SignalingRelayCandidate[]): Promise<string>;
|
|
1300
|
+
/**
|
|
1301
|
+
* A relay as a person reads it: the name a direct relay goes by when it has
|
|
1302
|
+
* one (ef0d4c0a988ec0d2.decentralize.ooo), else the host of its URL, with its
|
|
1303
|
+
* port when it is not the usual one.
|
|
1304
|
+
*/
|
|
1305
|
+
declare function relayDisplayName(url: string): string;
|
|
1306
|
+
/**
|
|
1307
|
+
* Every relay a bootstrap's registry (/api/v1/relays) lists, plus the
|
|
1308
|
+
* bootstrap and fallbacks, with what each says about itself: node ID, kind
|
|
1309
|
+
* (a relay behind NAT is local), and whether it can only be reached through
|
|
1310
|
+
* its tunnel. The registry request is HTTP-only.
|
|
1311
|
+
*/
|
|
1312
|
+
declare function discoverSignalingRelays(options: {
|
|
1313
|
+
bootstrapServer: string;
|
|
1314
|
+
fallbackServers?: readonly string[];
|
|
1315
|
+
fetchImpl?: typeof fetch;
|
|
1316
|
+
timeoutMs?: number;
|
|
1317
|
+
/** DNS relay directory to read direct relays from (default _relays.peer.ooo); false for none. */
|
|
1318
|
+
directory?: string | false;
|
|
1319
|
+
}): Promise<RelayInfo[]>;
|
|
1320
|
+
/**
|
|
1321
|
+
* Whether this page may open the relay's URL at all. An https page cannot
|
|
1322
|
+
* open a plain ws:// connection except to this machine (browsers block it
|
|
1323
|
+
* as mixed content), so a relay at ws://<public ip> is never tried there; a
|
|
1324
|
+
* browser reaches such a relay through its direct (WebRTC) address instead.
|
|
1325
|
+
*/
|
|
1326
|
+
declare function reachableFromThisPage(url: string): boolean;
|
|
1327
|
+
/**
|
|
1328
|
+
* Read the public relay registry from one bootstrap, then order the relays.
|
|
1329
|
+
* Given a network and room, relays are chosen for the room (chooseRelays:
|
|
1330
|
+
* the room's relays, healthy local ones first, then by measured score);
|
|
1331
|
+
* otherwise they are ranked by node-ID distance to the peer ID.
|
|
1332
|
+
*/
|
|
1333
|
+
declare function discoverClosestSignalingServers(options: {
|
|
1334
|
+
bootstrapServer: string;
|
|
1335
|
+
peerId: string;
|
|
1336
|
+
fallbackServers?: readonly string[];
|
|
1337
|
+
fetchImpl?: typeof fetch;
|
|
1338
|
+
timeoutMs?: number;
|
|
1339
|
+
limit?: number;
|
|
1340
|
+
network?: string;
|
|
1341
|
+
room?: string;
|
|
1342
|
+
measurements?: (nodeId: string) => RelayMeasurement | null | undefined;
|
|
1343
|
+
previousUrl?: string | null;
|
|
1344
|
+
onRelays?: (relays: RelayInfo[]) => void;
|
|
1345
|
+
directory?: string | false;
|
|
1346
|
+
}): Promise<string[]>;
|
|
1347
|
+
declare function discoverClosestSignalingServer(options: {
|
|
1348
|
+
bootstrapServer: string;
|
|
1349
|
+
peerId: string;
|
|
1350
|
+
fallbackServers?: readonly string[];
|
|
1351
|
+
fetchImpl?: typeof fetch;
|
|
1352
|
+
timeoutMs?: number;
|
|
1353
|
+
}): Promise<string>;
|
|
1354
|
+
interface PartialMeshConfig {
|
|
1355
|
+
/**
|
|
1356
|
+
* What this peer is, said in its announce (capabilities.role) and listed by
|
|
1357
|
+
* relays with it: a short lowercase word, such as 'storage'. Default: none.
|
|
1358
|
+
*/
|
|
1359
|
+
role?: string | null;
|
|
1360
|
+
/**
|
|
1361
|
+
* Which roles this peer dials on its own: null (default) dials any peer;
|
|
1362
|
+
* ['storage'] only peers listed with that role; [] none at all (it still
|
|
1363
|
+
* answers dials, and connectToPeer still dials anyone).
|
|
1364
|
+
*/
|
|
1365
|
+
dialRoles?: readonly string[] | null;
|
|
1366
|
+
/**
|
|
1367
|
+
* Minimum number of peers to maintain connections with
|
|
1368
|
+
*/
|
|
1369
|
+
minPeers?: number;
|
|
1370
|
+
/**
|
|
1371
|
+
* Maximum number of peers to maintain connections with
|
|
1372
|
+
*/
|
|
1373
|
+
maxPeers?: number;
|
|
1374
|
+
/**
|
|
1375
|
+
* Additional temporary peers allowed above maxPeers before trimming.
|
|
1376
|
+
*/
|
|
1377
|
+
tolerantPeers?: number;
|
|
1378
|
+
/**
|
|
1379
|
+
* FreeRTC signaling server URL
|
|
1380
|
+
*/
|
|
1381
|
+
signalingServer?: string;
|
|
1382
|
+
/** Known relays used if the bootstrap registry is empty or unavailable. */
|
|
1383
|
+
signalingServers?: readonly string[];
|
|
1384
|
+
/** Resolve one relay closest to the peer ID before opening signaling. */
|
|
1385
|
+
automaticSignalingServer?: boolean;
|
|
1386
|
+
/**
|
|
1387
|
+
* DNS relay directory to look direct relays up in (one DNS-over-HTTPS
|
|
1388
|
+
* lookup), with automaticSignalingServer. Default _relays.peer.ooo; false to
|
|
1389
|
+
* use only the bootstrap's registry.
|
|
1390
|
+
*/
|
|
1391
|
+
relayDirectory?: string | false;
|
|
1392
|
+
/** Write PeerPigeon's own console messages (hard resets, errors thrown by event handlers). Off by default. */
|
|
1393
|
+
debug?: boolean;
|
|
1394
|
+
/**
|
|
1395
|
+
* FreeRTC network/application namespace. Peers must match both networkId and
|
|
1396
|
+
* sessionId (room) even when they use different federated relay domains.
|
|
1397
|
+
*/
|
|
1398
|
+
networkId?: string;
|
|
1399
|
+
/**
|
|
1400
|
+
* Session/room ID for peer discovery
|
|
1401
|
+
*/
|
|
1402
|
+
sessionId?: string;
|
|
1403
|
+
/**
|
|
1404
|
+
* Automatically discover peers through the signaling server
|
|
1405
|
+
*/
|
|
1406
|
+
autoDiscover?: boolean;
|
|
1407
|
+
/**
|
|
1408
|
+
* Automatically connect to discovered peers
|
|
1409
|
+
*/
|
|
1410
|
+
autoConnect?: boolean;
|
|
1411
|
+
/**
|
|
1412
|
+
* ICE servers configuration for STUN/TURN.
|
|
1413
|
+
* Set to null to use FreeRTC defaults.
|
|
1414
|
+
*/
|
|
1415
|
+
iceServers?: RTCIceServer[] | null;
|
|
1416
|
+
/**
|
|
1417
|
+
* How long to wait for a peer connection to reach 'connect' before retrying.
|
|
1418
|
+
* Helps avoid peers getting stuck in 'connecting' indefinitely.
|
|
1419
|
+
*/
|
|
1420
|
+
connectionTimeoutMs?: number;
|
|
1421
|
+
/**
|
|
1422
|
+
* Periodic maintenance interval for autoConnect.
|
|
1423
|
+
* When set, the mesh will periodically attempt to converge to the desired connection count.
|
|
1424
|
+
*/
|
|
1425
|
+
maintenanceIntervalMs?: number;
|
|
1426
|
+
/**
|
|
1427
|
+
* If set (>0), refresh discovery when the mesh remains under-connected for
|
|
1428
|
+
* this long. Existing FreeRTC negotiations are preserved.
|
|
1429
|
+
*/
|
|
1430
|
+
underConnectedResetMs?: number;
|
|
1431
|
+
/** @deprecated Offers are immediate from either side; retained for API compatibility. */
|
|
1432
|
+
nonInitiatorFallbackDialMs?: number;
|
|
1433
|
+
/**
|
|
1434
|
+
* Age after which a relayed capacity advertisement stops influencing dial
|
|
1435
|
+
* priority. The last advertised value remains available in API snapshots.
|
|
1436
|
+
*/
|
|
1437
|
+
peerStateMaxAgeMs?: number;
|
|
1438
|
+
/**
|
|
1439
|
+
* Whether SDP should be sent before ICE gathering completes.
|
|
1440
|
+
* Disable to emit full offer/answer payloads after ICE gathering finishes.
|
|
1441
|
+
*/
|
|
1442
|
+
trickleIce?: boolean;
|
|
1443
|
+
/** Lifetime of an alive CECR membership record. Default 30 seconds. */
|
|
1444
|
+
membershipLeaseMs?: number;
|
|
1445
|
+
/** Interval for renewing and disseminating membership records. Default 5 seconds. */
|
|
1446
|
+
membershipGossipIntervalMs?: number;
|
|
1447
|
+
/** Retention period for explicit-left tombstones. Default 2 minutes. */
|
|
1448
|
+
membershipTombstoneRetentionMs?: number;
|
|
1449
|
+
/** Maximum accepted clock skew for CECR membership timestamps. Default 5 seconds. */
|
|
1450
|
+
membershipClockSkewMs?: number;
|
|
1451
|
+
}
|
|
1452
|
+
interface PeerConnection {
|
|
1453
|
+
id: string;
|
|
1454
|
+
connected: boolean;
|
|
1455
|
+
initiator: boolean;
|
|
1456
|
+
}
|
|
1457
|
+
type PeerCapacityAdvertisement = {
|
|
1458
|
+
maxPeers: number;
|
|
1459
|
+
connectedPeers: number;
|
|
1460
|
+
updatedAt: number;
|
|
1461
|
+
};
|
|
1462
|
+
type PeerCapacitySnapshot = PeerCapacityAdvertisement & {
|
|
1463
|
+
peerId: string;
|
|
1464
|
+
availableSlots: number;
|
|
1465
|
+
fresh: boolean;
|
|
1466
|
+
local: boolean;
|
|
1467
|
+
};
|
|
1468
|
+
type CecrMembershipRecordSnapshot = {
|
|
1469
|
+
peerId: string;
|
|
1470
|
+
incarnation: number;
|
|
1471
|
+
sequence: number;
|
|
1472
|
+
state: 'alive' | 'left';
|
|
1473
|
+
issuedAt: number;
|
|
1474
|
+
validUntil: number | null;
|
|
1475
|
+
};
|
|
1476
|
+
type PeerGraphNode = {
|
|
1477
|
+
peerId: string;
|
|
1478
|
+
local: boolean;
|
|
1479
|
+
directlyConnected: boolean;
|
|
1480
|
+
discovered: boolean;
|
|
1481
|
+
capacity: PeerCapacitySnapshot | null;
|
|
1482
|
+
/** Shortest known topology path from the local peer: local=0, direct=1. */
|
|
1483
|
+
hopDistance: number | null;
|
|
1484
|
+
/** XOR-space distance from the local peer, encoded as an exact hex string. */
|
|
1485
|
+
xorDistance: string | null;
|
|
1486
|
+
/** Zero-based nearest-first rank, excluding the local peer. */
|
|
1487
|
+
xorDistanceRank: number | null;
|
|
1488
|
+
/** Relative distance in the known set: nearest=0, farthest=1. */
|
|
1489
|
+
xorDistanceRatio: number | null;
|
|
1490
|
+
};
|
|
1491
|
+
type PeerGraphEdge = {
|
|
1492
|
+
source: string;
|
|
1493
|
+
target: string;
|
|
1494
|
+
direct: boolean;
|
|
1495
|
+
observedBy: string[];
|
|
1496
|
+
updatedAt: number;
|
|
1497
|
+
};
|
|
1498
|
+
type PeerGraphSnapshot = {
|
|
1499
|
+
localPeerId: string | null;
|
|
1500
|
+
nodes: PeerGraphNode[];
|
|
1501
|
+
edges: PeerGraphEdge[];
|
|
1502
|
+
/** True once every known peer has supplied at least one adjacency snapshot. */
|
|
1503
|
+
complete: boolean;
|
|
1504
|
+
missingTopologyPeerIds: string[];
|
|
1505
|
+
generatedAt: number;
|
|
1506
|
+
};
|
|
1507
|
+
type PartialMeshRuntimeConfig = Pick<Required<PartialMeshConfig>, 'minPeers' | 'maxPeers' | 'tolerantPeers' | 'autoDiscover' | 'autoConnect' | 'connectionTimeoutMs' | 'maintenanceIntervalMs' | 'underConnectedResetMs' | 'nonInitiatorFallbackDialMs' | 'peerStateMaxAgeMs'>;
|
|
1508
|
+
type PartialMeshEvents = {
|
|
1509
|
+
'identity:ready': (data: {
|
|
1510
|
+
clientId: string;
|
|
1511
|
+
}) => void;
|
|
1512
|
+
'signaling:connected': (data: {
|
|
1513
|
+
clientId: string;
|
|
1514
|
+
rawClientId?: string;
|
|
1515
|
+
signalingServer?: string;
|
|
1516
|
+
}) => void;
|
|
1517
|
+
'signaling:disconnected': () => void;
|
|
1518
|
+
'signaling:error': (error: any) => void;
|
|
1519
|
+
'signaling:log': (data: {
|
|
1520
|
+
message: string;
|
|
1521
|
+
}) => void;
|
|
1522
|
+
'peer:connected': (peerId: string) => void;
|
|
1523
|
+
'peer:disconnected': (peerId: string) => void;
|
|
1524
|
+
'peer:data': (data: {
|
|
1525
|
+
peerId: string;
|
|
1526
|
+
data: any;
|
|
1527
|
+
}) => void;
|
|
1528
|
+
'peer:bytes': (data: {
|
|
1529
|
+
peerId: string;
|
|
1530
|
+
meta: Record<string, unknown>;
|
|
1531
|
+
bytes: Uint8Array;
|
|
1532
|
+
}) => void;
|
|
1533
|
+
'peer:error': (data: {
|
|
1534
|
+
peerId: string;
|
|
1535
|
+
error: any;
|
|
1536
|
+
}) => void;
|
|
1537
|
+
'peer:discovered': (peerId: string) => void;
|
|
1538
|
+
'mesh:ready': () => void;
|
|
1539
|
+
'mesh:membership': (peers: string[]) => void;
|
|
1540
|
+
'mesh:capacity': (capacities: PeerCapacitySnapshot[]) => void;
|
|
1541
|
+
'mesh:graph': (snapshot: PeerGraphSnapshot) => void;
|
|
1542
|
+
};
|
|
1543
|
+
declare class PartialMesh {
|
|
1544
|
+
private config;
|
|
1545
|
+
private readonly role;
|
|
1546
|
+
private readonly dialRoles;
|
|
1547
|
+
private peers;
|
|
1548
|
+
private signalingClient;
|
|
1549
|
+
private discoveredPeers;
|
|
1550
|
+
private clientId;
|
|
1551
|
+
private selfAliases;
|
|
1552
|
+
private retiredPeerIds;
|
|
1553
|
+
private relayScores;
|
|
1554
|
+
private relayNodeIds;
|
|
1555
|
+
private relayAttemptStartedAt;
|
|
1556
|
+
private eventHandlers;
|
|
1557
|
+
private connecting;
|
|
1558
|
+
private connectionStartedAtMs;
|
|
1559
|
+
private negotiationPhaseByPeerId;
|
|
1560
|
+
/** First local observation of FreeRTC negotiations not tracked by PartialMesh. */
|
|
1561
|
+
private orphanRtcFirstSeenAtMs;
|
|
1562
|
+
private peerConnectedAtMs;
|
|
1563
|
+
private linkLog;
|
|
1564
|
+
private discoveredAtMs;
|
|
1565
|
+
/** Peers present in the relay's latest un-graced discovery snapshot. */
|
|
1566
|
+
private activeSignalingPeers;
|
|
1567
|
+
private meshSignaling;
|
|
1568
|
+
/** Whether the relay has supplied an authoritative active snapshot yet. */
|
|
1569
|
+
private hasActiveSignalingSnapshot;
|
|
1570
|
+
private maintenanceTimer;
|
|
1571
|
+
private membershipTimer;
|
|
1572
|
+
private underConnectedSinceMs;
|
|
1573
|
+
private lastHardResetAtMs;
|
|
1574
|
+
private lastUnderConnectedRecoveryAtMs;
|
|
1575
|
+
private lastDiscoveryRefreshAtMs;
|
|
1576
|
+
private discoveryRefreshWaitMs;
|
|
1577
|
+
private lastSignalingReconnectAtMs;
|
|
1578
|
+
private dialFailureCount;
|
|
1579
|
+
private lastDialFailureAtMs;
|
|
1580
|
+
private dialBackoffUntilMs;
|
|
1581
|
+
private rebalanceCooldownUntilMs;
|
|
1582
|
+
private rebalanceCooldownMs;
|
|
1583
|
+
private rebalanceAttemptAtMs;
|
|
1584
|
+
private bridgeGraceUntilMs;
|
|
1585
|
+
private lastBridgeDialAtMs;
|
|
1586
|
+
private bridgeTrimTimer;
|
|
1587
|
+
private pendingRebalanceDropByTarget;
|
|
1588
|
+
/** Converged global peer membership — populated via in-band membership gossip. */
|
|
1589
|
+
private globalPeers;
|
|
1590
|
+
/** Versioned, expiring CECR membership records keyed by subject peer. */
|
|
1591
|
+
private membershipRecordsById;
|
|
1592
|
+
private membershipEquivocationAtById;
|
|
1593
|
+
private membershipIncarnation;
|
|
1594
|
+
private membershipSequence;
|
|
1595
|
+
/** Relayed per-peer capacity used to give scarce, underfilled peers priority. */
|
|
1596
|
+
private peerCapacityById;
|
|
1597
|
+
private fillBackoffMs;
|
|
1598
|
+
private localRelayTimer;
|
|
1599
|
+
private localRelayCheckRunning;
|
|
1600
|
+
private fillBackoffUntilMs;
|
|
1601
|
+
/** Relayed adjacency snapshots used to reconstruct the known network graph. */
|
|
1602
|
+
private peerTopologyById;
|
|
1603
|
+
private localCapacityUpdatedAtMs;
|
|
1604
|
+
private localTopologyUpdatedAtMs;
|
|
1605
|
+
constructor(config?: PartialMeshConfig);
|
|
1606
|
+
private validatePeerLimits;
|
|
1607
|
+
private normalizePeerId;
|
|
1608
|
+
private normalizeSignalingUrl;
|
|
1609
|
+
private addSelfAlias;
|
|
1610
|
+
private isSelfAlias;
|
|
1611
|
+
/** Real news arrived, so ask again at full speed. */
|
|
1612
|
+
private noteDiscoveryNews;
|
|
1613
|
+
/**
|
|
1614
|
+
* A peer that said it was leaving (its own 'left' membership record, which
|
|
1615
|
+
* only a newer 'alive' record from it overrides). Relay lists and gossip
|
|
1616
|
+
* can still name it for a while; it is not rediscovered or dialled.
|
|
1617
|
+
*/
|
|
1618
|
+
private hasLeft;
|
|
1619
|
+
/** Drop every trace of a peer that left, so nothing dials it again. */
|
|
1620
|
+
private forgetDepartedPeer;
|
|
1621
|
+
private addDiscoveredPeer;
|
|
1622
|
+
private loadOrCreateBrowserPeerId;
|
|
1623
|
+
private rememberBrowserPeerSignalUrls;
|
|
1624
|
+
private retirePeerId;
|
|
1625
|
+
/**
|
|
1626
|
+
* Give the mesh a way to carry signaling frames itself. Once set, a peer
|
|
1627
|
+
* the mesh can route to is dialed through connected neighbours, a relay
|
|
1628
|
+
* snapshot that omits it cannot cancel that dial, and it counts as a dial
|
|
1629
|
+
* candidate whether or not this relay ever lists it.
|
|
1630
|
+
*/
|
|
1631
|
+
setMeshSignaling(provider: MeshSignaling | null): void;
|
|
1632
|
+
private meshCanSignal;
|
|
1633
|
+
/**
|
|
1634
|
+
* A signaling envelope that arrived inside a gossip direct frame. The
|
|
1635
|
+
* frame's origin must be the envelope's sender: a neighbour can carry a
|
|
1636
|
+
* peer's offer, never author one on its behalf.
|
|
1637
|
+
*/
|
|
1638
|
+
receiveMeshSignal(fromPeerId: string, envelope: Record<string, unknown>): boolean;
|
|
1639
|
+
private reconcileSignalingPeers;
|
|
1640
|
+
private handleSignalingPeerLeft;
|
|
1641
|
+
private trackRtcNegotiation;
|
|
1642
|
+
private getConnectedPeerCount;
|
|
1643
|
+
private getPendingPeerCount;
|
|
1644
|
+
private noteLocalCapacityChanged;
|
|
1645
|
+
private freshPeerCapacity;
|
|
1646
|
+
/**
|
|
1647
|
+
* Known underfilled peers sort first, with lower-capacity peers ahead of
|
|
1648
|
+
* high-capacity peers. Unknown peers remain eligible; known-full peers sort last.
|
|
1649
|
+
*/
|
|
1650
|
+
private compareCapacityPriority;
|
|
1651
|
+
private compareDialCandidates;
|
|
1652
|
+
/** Direct neighbors whose local edge is the only known path to part of the mesh. */
|
|
1653
|
+
private localBridgeConnectedPeerIds;
|
|
1654
|
+
/**
|
|
1655
|
+
* A peer prefers a local relay (one in the DNS relay directory, reached
|
|
1656
|
+
* directly). While it signals through any other relay it looks the
|
|
1657
|
+
* directory up again every LOCAL_RELAY_CHECK_MS (a DNS-over-HTTPS lookup,
|
|
1658
|
+
* no relay request), and when a listed relay answers a test connection it
|
|
1659
|
+
* moves its signaling there; open peer channels stay up. So a peer that
|
|
1660
|
+
* fell back to a cloud relay while the local one was down goes back to it
|
|
1661
|
+
* once it is up.
|
|
1662
|
+
*/
|
|
1663
|
+
private startLocalRelayReturn;
|
|
1664
|
+
private returnToLocalRelay;
|
|
1665
|
+
private trimExcessPeers;
|
|
1666
|
+
private getOldestPendingAgeMs;
|
|
1667
|
+
private isHexId;
|
|
1668
|
+
private fastIdHash;
|
|
1669
|
+
private peerDistance;
|
|
1670
|
+
private cecrNumericPeerId;
|
|
1671
|
+
private cecrBucketRank;
|
|
1672
|
+
private cecrCoordinateNeighbors;
|
|
1673
|
+
/**
|
|
1674
|
+
* 0: a coordinate neighbour (the next peer either side in ID order). Those
|
|
1675
|
+
* links alone join every peer into one line, so they come before
|
|
1676
|
+
* anything else: with maxPeers 2 they are the whole topology.
|
|
1677
|
+
* 1: a peer in a distance bucket none of our links covers yet.
|
|
1678
|
+
* 2: anyone else.
|
|
1679
|
+
*/
|
|
1680
|
+
/** True while one of this peer's coordinate neighbours is not connected. */
|
|
1681
|
+
private missingCoordinateNeighbour;
|
|
1682
|
+
private cecrOverlayDialPriority;
|
|
1683
|
+
private cecrProtectedConnectedPeerIds;
|
|
1684
|
+
private maybeRebalanceForCloserPeer;
|
|
1685
|
+
/**
|
|
1686
|
+
* Initialize and connect to the signaling server
|
|
1687
|
+
*/
|
|
1688
|
+
init(): Promise<void>;
|
|
1689
|
+
private startMaintenanceLoop;
|
|
1690
|
+
private startMembershipLoop;
|
|
1691
|
+
private maybeRefreshDiscovery;
|
|
1692
|
+
/**
|
|
1693
|
+
* Revalidate transports after browser suspension, network changes, or focus
|
|
1694
|
+
* restoration. Browsers do not always deliver every lifecycle event, so the
|
|
1695
|
+
* maintenance loop also calls the same stale-channel check.
|
|
1696
|
+
*/
|
|
1697
|
+
recoverAfterInactivity(reason?: string): void;
|
|
1698
|
+
private recoverMeshAfterInactivity;
|
|
1699
|
+
private recoverStaleConnectedPeers;
|
|
1700
|
+
/**
|
|
1701
|
+
* FreeRTC can retain a half-open connection that never became a PartialMesh
|
|
1702
|
+
* peer. Without local peer/pending state, the normal negotiation watchdog
|
|
1703
|
+
* cannot see it, while connectToPeerInternal treats it as active forever.
|
|
1704
|
+
*/
|
|
1705
|
+
private recoverOrphanedRtcNegotiations;
|
|
1706
|
+
private maybeRecoverStalledNegotiations;
|
|
1707
|
+
private maybeHardResetUnderConnected;
|
|
1708
|
+
private isPeerBackedOff;
|
|
1709
|
+
private noteDialFailure;
|
|
1710
|
+
private noteDialSuccess;
|
|
1711
|
+
private forgetStaleDialFailures;
|
|
1712
|
+
private noteLink;
|
|
1713
|
+
/** The last links that opened or closed, newest last: when, which peer, and why it closed. */
|
|
1714
|
+
getLinkLog(): Array<{
|
|
1715
|
+
at: number;
|
|
1716
|
+
peer: string;
|
|
1717
|
+
event: 'up' | 'down';
|
|
1718
|
+
by: 'local' | 'remote';
|
|
1719
|
+
reason: string;
|
|
1720
|
+
links: number;
|
|
1721
|
+
}>;
|
|
1722
|
+
private noteTransportDisconnect;
|
|
1723
|
+
private noteStablePeerConnections;
|
|
1724
|
+
private noteIntentionalShed;
|
|
1725
|
+
/**
|
|
1726
|
+
* Hard reset peer connections (keeps signaling + discovered peers).
|
|
1727
|
+
* Useful for recovering from rare stuck negotiation/ICE states.
|
|
1728
|
+
*/
|
|
1729
|
+
hardReset(reason?: string): void;
|
|
1730
|
+
/**
|
|
1731
|
+
* Create a new peer connection
|
|
1732
|
+
*/
|
|
1733
|
+
private createPeerConnection;
|
|
1734
|
+
/**
|
|
1735
|
+
* Maintain the target number of peer connections
|
|
1736
|
+
*/
|
|
1737
|
+
private dialCandidatePeerIds;
|
|
1738
|
+
/** The role a relay listed this peer with (its announce's capabilities.role), or null. */
|
|
1739
|
+
getPeerRole(peerId: string): string | null;
|
|
1740
|
+
/** Whether this peer dials that one on its own (dialRoles). */
|
|
1741
|
+
private dialsRole;
|
|
1742
|
+
private maintainPeerConnections;
|
|
1743
|
+
/**
|
|
1744
|
+
* Connect to a specific peer
|
|
1745
|
+
*/
|
|
1746
|
+
connectToPeer(peerId: string): void;
|
|
1747
|
+
private connectToPeerInternal;
|
|
1748
|
+
/**
|
|
1749
|
+
* Disconnect from a specific peer
|
|
1750
|
+
*/
|
|
1751
|
+
disconnectFromPeer(peerId: string, reason?: string): void;
|
|
1752
|
+
/**
|
|
1753
|
+
* Remove a peer connection
|
|
1754
|
+
*/
|
|
1755
|
+
private removePeer;
|
|
1756
|
+
/**
|
|
1757
|
+
* Send data to a specific peer
|
|
1758
|
+
*/
|
|
1759
|
+
send(peerId: string, data: string | ArrayBuffer | ArrayBufferView): void;
|
|
1760
|
+
/**
|
|
1761
|
+
* A message with bytes to a linked neighbour, as one binary frame (no base64, no JSON escaping):
|
|
1762
|
+
* false when the peer is not linked or the frame is refused. The receiver must read them (it said so).
|
|
1763
|
+
*/
|
|
1764
|
+
sendBytes(peerId: string, meta: Record<string, unknown>, bytes: Uint8Array): boolean;
|
|
1765
|
+
/**
|
|
1766
|
+
* Broadcast data to all connected peers
|
|
1767
|
+
*/
|
|
1768
|
+
broadcast(data: string | ArrayBuffer | ArrayBufferView): void;
|
|
1769
|
+
/**
|
|
1770
|
+
* Get list of connected peer IDs
|
|
1771
|
+
*/
|
|
1772
|
+
/**
|
|
1773
|
+
* Ask the relay this peer is on to do something itself, such as a PigeonIdP
|
|
1774
|
+
* account lookup ({ action: 'idp-get', namespace, alias }). Resolves with the
|
|
1775
|
+
* relay's answer ({ ok: false, error: 'unsupported' } from a relay that does
|
|
1776
|
+
* not serve it); rejects when not on a relay or when no answer comes.
|
|
1777
|
+
*/
|
|
1778
|
+
relayRequest(body: Record<string, unknown>, options?: {
|
|
1779
|
+
timeoutMs?: number;
|
|
1780
|
+
}): Promise<any>;
|
|
1781
|
+
/** Smoothed round trip of the link to a neighbour, ms, measured by its keepalive; null when unknown. */
|
|
1782
|
+
getLinkRttMs(peerId: string): number | null;
|
|
1783
|
+
getConnectedPeers(): string[];
|
|
1784
|
+
/**
|
|
1785
|
+
* Get list of discovered peer IDs
|
|
1786
|
+
*/
|
|
1787
|
+
getDiscoveredPeers(): string[];
|
|
1788
|
+
/** Return peers in the relay's latest non-graced discovery snapshot. */
|
|
1789
|
+
getActiveSignalingPeers(): string[];
|
|
1790
|
+
/**
|
|
1791
|
+
* Get the converged global peer set (all peers known via membership gossip).
|
|
1792
|
+
*/
|
|
1793
|
+
getGlobalPeers(): string[];
|
|
1794
|
+
getCecrMembershipRecords(): CecrMembershipRecordSnapshot[];
|
|
1795
|
+
getCecrMembershipEquivocations(): string[];
|
|
1796
|
+
getCecrMembershipConfig(): Readonly<{
|
|
1797
|
+
leaseMs: number;
|
|
1798
|
+
gossipIntervalMs: number;
|
|
1799
|
+
tombstoneRetentionMs: number;
|
|
1800
|
+
clockSkewMs: number;
|
|
1801
|
+
}>;
|
|
1802
|
+
/** Return the effective configuration, including constructor defaults. */
|
|
1803
|
+
/** This peer's relay measurements (own and shared), used to choose relays. */
|
|
1804
|
+
getRelayScores(): RelayScoreBook;
|
|
1805
|
+
getConfig(): Readonly<Required<PartialMeshConfig>>;
|
|
1806
|
+
/**
|
|
1807
|
+
* Update connection-policy knobs without rebuilding the node. Signaling,
|
|
1808
|
+
* network/session identity, ICE, and trickle settings remain constructor-time
|
|
1809
|
+
* values because changing them requires reconnecting the transport.
|
|
1810
|
+
*/
|
|
1811
|
+
updateConfig(patch: Partial<PartialMeshRuntimeConfig>): Readonly<Required<PartialMeshConfig>>;
|
|
1812
|
+
/** Return capacity and available connection slots for one known peer. */
|
|
1813
|
+
getPeerCapacity(peerId: string): PeerCapacitySnapshot | null;
|
|
1814
|
+
/** Return advertised capacity for every known peer, including this node. */
|
|
1815
|
+
getPeerCapacities(): PeerCapacitySnapshot[];
|
|
1816
|
+
/** Return the exact XOR-space distance used by partial-mesh rebalancing. */
|
|
1817
|
+
getXorDistance(peerId: string, fromPeerId?: string | null): string | null;
|
|
1818
|
+
/** Return the shortest currently-known topology path from this peer. */
|
|
1819
|
+
getHopDistance(peerId: string): number | null;
|
|
1820
|
+
/** Reconstruct the complete currently-known node and undirected edge snapshot. */
|
|
1821
|
+
getGraphSnapshot(): PeerGraphSnapshot;
|
|
1822
|
+
/**
|
|
1823
|
+
* Get current peer count
|
|
1824
|
+
*/
|
|
1825
|
+
getPeerCount(): number;
|
|
1826
|
+
/**
|
|
1827
|
+
* Get this client's ID
|
|
1828
|
+
*/
|
|
1829
|
+
getClientId(): string | null;
|
|
1830
|
+
/**
|
|
1831
|
+
* Register an event handler
|
|
1832
|
+
*/
|
|
1833
|
+
on<K extends keyof PartialMeshEvents>(event: K, handler: PartialMeshEvents[K]): void;
|
|
1834
|
+
/**
|
|
1835
|
+
* Unregister an event handler
|
|
1836
|
+
*/
|
|
1837
|
+
off<K extends keyof PartialMeshEvents>(event: K, handler: PartialMeshEvents[K]): void;
|
|
1838
|
+
/**
|
|
1839
|
+
* Emit an event
|
|
1840
|
+
*/
|
|
1841
|
+
private emit;
|
|
1842
|
+
private renewLocalMembership;
|
|
1843
|
+
private isMembershipRecordNewer;
|
|
1844
|
+
private mergeMembershipRecord;
|
|
1845
|
+
private rebuildGlobalMembership;
|
|
1846
|
+
private pruneMembershipRecords;
|
|
1847
|
+
private membershipRecordsForWire;
|
|
1848
|
+
private sendMembership;
|
|
1849
|
+
private membershipBroadcastAtMs;
|
|
1850
|
+
private membershipBroadcastTimer;
|
|
1851
|
+
private renewalForwardIds;
|
|
1852
|
+
private renewalForwardTimer;
|
|
1853
|
+
private forwardMembershipRecords;
|
|
1854
|
+
private broadcastMembership;
|
|
1855
|
+
private tryParseMembership;
|
|
1856
|
+
private mergeMembership;
|
|
1857
|
+
/**
|
|
1858
|
+
* Tell our neighbours we are leaving: a CECR 'left' record for ourselves,
|
|
1859
|
+
* which each of them merges and forwards. Without it the network keeps us
|
|
1860
|
+
* as a member until our lease runs out (up to membershipLeaseMs): peers
|
|
1861
|
+
* keep us as a ring neighbour, keep dialling us, and keep counting the
|
|
1862
|
+
* links our last report listed. A peer that dies without saying goodbye
|
|
1863
|
+
* still ages out by its lease. Returns whether anyone was told.
|
|
1864
|
+
*/
|
|
1865
|
+
announceLeave(): boolean;
|
|
1866
|
+
/**
|
|
1867
|
+
* Disconnect from all peers and close signaling connection. Neighbours are
|
|
1868
|
+
* told we are leaving first (see announceLeave), and the links close
|
|
1869
|
+
* LEAVE_FLUSH_MS later so that frame is not dropped with them. Returns how
|
|
1870
|
+
* long the links stay open (0 when nobody was told); a caller about to end
|
|
1871
|
+
* the process should wait that long.
|
|
1872
|
+
*/
|
|
1873
|
+
destroy(): number;
|
|
1874
|
+
}
|
|
1875
|
+
type PeerPigeonNodeStorageOptions = Omit<StorageOptions, 'gossip' | 'peerId' | 'userId'> & {
|
|
1876
|
+
userId?: string;
|
|
1877
|
+
/**
|
|
1878
|
+
* Use storage servers when there are any (default: true): the room's
|
|
1879
|
+
* records go to its closest servers, are read from them, and move to them
|
|
1880
|
+
* from here (see storage-servers.ts). false keeps storage on the mesh alone.
|
|
1881
|
+
*/
|
|
1882
|
+
servers?: boolean;
|
|
1883
|
+
};
|
|
1884
|
+
type PeerPigeonNodeOptions = PartialMeshConfig & {
|
|
1885
|
+
gossip?: GossipProtocolOptions;
|
|
1886
|
+
/** Enabled by default. Pass false to construct a node without crypto. */
|
|
1887
|
+
crypto?: false | (Omit<PeerPigeonCryptoOptions, 'roomId'> & {
|
|
1888
|
+
roomId?: string;
|
|
1889
|
+
});
|
|
1890
|
+
/** Disabled by default. Pass options to attach encrypted synchronized storage. */
|
|
1891
|
+
storage?: false | PeerPigeonNodeStorageOptions;
|
|
1892
|
+
};
|
|
1893
|
+
type PeerPigeonNodeMessage = {
|
|
1894
|
+
kind: 'broadcast' | 'direct';
|
|
1895
|
+
data: unknown;
|
|
1896
|
+
encrypted: boolean;
|
|
1897
|
+
local: boolean;
|
|
1898
|
+
fromPeerId: string | null;
|
|
1899
|
+
messageId: string;
|
|
1900
|
+
hops: number;
|
|
1901
|
+
message: GossipMessage | DirectMessage;
|
|
1902
|
+
};
|
|
1903
|
+
type PeerPigeonNodeEvents = {
|
|
1904
|
+
ready: () => void;
|
|
1905
|
+
peerConnected: (peerId: string) => void;
|
|
1906
|
+
peerDisconnected: (peerId: string) => void;
|
|
1907
|
+
graphChanged: (snapshot: PeerGraphSnapshot) => void;
|
|
1908
|
+
capacityChanged: (capacities: PeerCapacitySnapshot[]) => void;
|
|
1909
|
+
keyDiscovered: (key: PeerPublicKey) => void;
|
|
1910
|
+
message: (message: PeerPigeonNodeMessage) => void;
|
|
1911
|
+
deliveryProgress: (status: GossipDeliveryStatus) => void;
|
|
1912
|
+
deliveryComplete: (status: GossipDeliveryStatus) => void;
|
|
1913
|
+
deliveryTimeout: (status: GossipDeliveryStatus) => void;
|
|
1914
|
+
aggregateProgress: (status: GossipAggregateDeliveryStatus) => void;
|
|
1915
|
+
aggregateSettled: (status: GossipAggregateDeliveryStatus) => void;
|
|
1916
|
+
cecrStateChanged: (state: CecrStateSnapshot) => void;
|
|
1917
|
+
error: (error: Error) => void;
|
|
1918
|
+
};
|
|
1919
|
+
declare class PeerPigeonNode {
|
|
1920
|
+
readonly mesh: PartialMesh;
|
|
1921
|
+
readonly gossip: GossipProtocol;
|
|
1922
|
+
readonly crypto: PeerPigeonCryptoProtocol | null;
|
|
1923
|
+
storage: PeerPigeonStorage | null;
|
|
1924
|
+
private readonly storageOptions;
|
|
1925
|
+
private readonly signalingOptions;
|
|
1926
|
+
private serverLink;
|
|
1927
|
+
private linking;
|
|
1928
|
+
private storageUserId;
|
|
1929
|
+
private readonly openedStorages;
|
|
1930
|
+
private readonly callbacks;
|
|
1931
|
+
private started;
|
|
1932
|
+
private relayScoreTimer;
|
|
1933
|
+
constructor(options?: PeerPigeonNodeOptions);
|
|
1934
|
+
init(): Promise<void>;
|
|
1935
|
+
start(): Promise<void>;
|
|
1936
|
+
private useServers;
|
|
1937
|
+
/** The relay this node is signalling through now ('' until it has one). */
|
|
1938
|
+
currentRelay(): string;
|
|
1939
|
+
/** The relay this node uses, as a person reads it (a direct relay by its name). */
|
|
1940
|
+
currentRelayName(): string;
|
|
1941
|
+
/**
|
|
1942
|
+
* A storage room of its own (one person's records, say: name it after their key), kept on the
|
|
1943
|
+
* same storage servers as this node's room. Listing it reads only what is in it, however much
|
|
1944
|
+
* the node's room holds. Only the servers keep it: the mesh does not sync it.
|
|
1945
|
+
* signingKeys: whose changes these are (an account's, after sign-in); by default this node's.
|
|
1946
|
+
* owner: a key, for a room only that key writes to (the storage servers take nothing else in it);
|
|
1947
|
+
* writes here must then be signed by it.
|
|
1948
|
+
* Close it with storage.close() when done (the node closes those still open when it stops).
|
|
1949
|
+
*/
|
|
1950
|
+
openStorage(sessionId: string, options?: {
|
|
1951
|
+
signingKeys?: {
|
|
1952
|
+
pub: string;
|
|
1953
|
+
priv: string;
|
|
1954
|
+
} | null;
|
|
1955
|
+
owner?: string;
|
|
1956
|
+
}): Promise<PeerPigeonStorage>;
|
|
1957
|
+
private linkServers;
|
|
1958
|
+
getConfig(): Readonly<Required<PartialMeshConfig>>;
|
|
1959
|
+
updateConfig(patch: Partial<PartialMeshRuntimeConfig>): Readonly<Required<PartialMeshConfig>>;
|
|
1960
|
+
getGraphSnapshot(): PeerGraphSnapshot;
|
|
1961
|
+
getPeerCapacity(peerId: string): PeerCapacitySnapshot | null;
|
|
1962
|
+
getPeerCapacities(): PeerCapacitySnapshot[];
|
|
1963
|
+
getXorDistance(peerId: string, fromPeerId?: string): string | null;
|
|
1964
|
+
getHopDistance(peerId: string): number | null;
|
|
1965
|
+
getCecrConfig(): Readonly<CecrConfigSnapshot>;
|
|
1966
|
+
getCecrState(): CecrStateSnapshot;
|
|
1967
|
+
getClientId(): string | null;
|
|
1968
|
+
getConnectedPeers(): string[];
|
|
1969
|
+
/**
|
|
1970
|
+
* A direct message with bytes to a linked neighbour, in one binary frame: it arrives as a 'message'
|
|
1971
|
+
* (kind 'direct') whose data is `meta` with `bytes` added. Only to a peer that reads them (one that
|
|
1972
|
+
* asked for bytes); false when it can't go (not linked: send without bytes instead).
|
|
1973
|
+
*/
|
|
1974
|
+
sendBytes(peerId: string, meta: Record<string, unknown>, bytes: Uint8Array): boolean;
|
|
1975
|
+
getLinkLog(): {
|
|
1976
|
+
at: number;
|
|
1977
|
+
peer: string;
|
|
1978
|
+
event: "up" | "down";
|
|
1979
|
+
by: "local" | "remote";
|
|
1980
|
+
reason: string;
|
|
1981
|
+
links: number;
|
|
1982
|
+
}[];
|
|
1983
|
+
getDiscoveredPeers(): string[];
|
|
1984
|
+
/** The role a relay listed this peer with, or null. */
|
|
1985
|
+
getPeerRole(peerId: string): string | null;
|
|
1986
|
+
/** Dial this peer now, whatever its role. */
|
|
1987
|
+
connectToPeer(peerId: string): void;
|
|
1988
|
+
getActiveSignalingPeers(): string[];
|
|
1989
|
+
getGlobalPeers(): string[];
|
|
1990
|
+
broadcast(data: unknown, metadata?: Record<string, unknown>, options?: GossipBroadcastOptions): string;
|
|
1991
|
+
broadcastReliable(data: unknown, metadata?: Record<string, unknown>, options?: Omit<GossipBroadcastOptions, 'trackDelivery'>): string;
|
|
1992
|
+
sendDirect(peerId: string, data: unknown): string | null;
|
|
1993
|
+
getDeliveryStatus(messageId: string): GossipDeliveryStatus | null;
|
|
1994
|
+
getAggregateDeliveryStatus(messageId: string): GossipAggregateDeliveryStatus | null;
|
|
1995
|
+
broadcastEncrypted(plaintext: string, metadata?: Record<string, unknown>, options?: GossipBroadcastOptions): Promise<string>;
|
|
1996
|
+
broadcastEncryptedReliable(plaintext: string, metadata?: Record<string, unknown>, options?: Omit<GossipBroadcastOptions, 'trackDelivery'>): Promise<string>;
|
|
1997
|
+
sendEncryptedDirect(peerId: string, plaintext: string, timeoutMs?: number): Promise<string>;
|
|
1998
|
+
/**
|
|
1999
|
+
* This peer's identity, secret keys included: what makes it the owner of its
|
|
2000
|
+
* records. Kept in this browser between visits; give it as crypto.keyPair on
|
|
2001
|
+
* another device (or after clearing the browser) to be the same person there.
|
|
2002
|
+
*/
|
|
2003
|
+
getKeyPair(): Readonly<PeerPigeonKeyPair>;
|
|
2004
|
+
getPublicKey(peerId: string): PeerPublicKey | null;
|
|
2005
|
+
getKnownPeerKeys(): PeerPublicKey[];
|
|
2006
|
+
requestPeerKey(peerId: string): void;
|
|
2007
|
+
waitForPeerKey(peerId: string, timeoutMs?: number): Promise<PeerPublicKey>;
|
|
2008
|
+
recoverAfterInactivity(reason?: string): void;
|
|
2009
|
+
on<K extends keyof PeerPigeonNodeEvents>(event: K, callback: PeerPigeonNodeEvents[K]): void;
|
|
2010
|
+
off<K extends keyof PeerPigeonNodeEvents>(event: K, callback: PeerPigeonNodeEvents[K]): void;
|
|
2011
|
+
/** This node's link to the storage servers (null with storage off, or storage.servers false). */
|
|
2012
|
+
get storageServers(): StorageServerLink | null;
|
|
2013
|
+
/**
|
|
2014
|
+
* A node in the storage servers' scope, on the same relays as this one: for
|
|
2015
|
+
* a server (role 'storage', dialing other servers) or a peer's link to them.
|
|
2016
|
+
*/
|
|
2017
|
+
static serverScopeNode(signaling: Pick<PartialMeshConfig, 'signalingServer' | 'signalingServers' | 'automaticSignalingServer' | 'relayDirectory' | 'iceServers'>, options?: Pick<PartialMeshConfig, 'role' | 'dialRoles' | 'maxPeers' | 'minPeers'>): PeerPigeonNode;
|
|
2018
|
+
/** A storage server on the same relays as this node's settings (see storage-servers.ts). */
|
|
2019
|
+
static storageServer(signaling?: Pick<PartialMeshConfig, 'signalingServer' | 'signalingServers' | 'automaticSignalingServer' | 'relayDirectory' | 'iceServers'>, store?: ServerRecordStore): StorageServer;
|
|
2020
|
+
destroy(): Promise<void>;
|
|
2021
|
+
private bindComponentEvents;
|
|
2022
|
+
private isReservedPayload;
|
|
2023
|
+
private emitError;
|
|
2024
|
+
private emit;
|
|
2025
|
+
}
|
|
2026
|
+
|
|
2027
|
+
export { type CecrConfigSnapshot, type CecrMembershipRecordSnapshot, type CecrOverlaySnapshot, type CecrStateSnapshot, DEFAULT_CLOSE_SIGNALING_RELAY_COUNT, DEFAULT_SIGNALING_SERVERS, type EncryptedBroadcastPayload, type EncryptedDirectPayload, type GossipAggregateDeliveryStatus, type GossipBroadcastOptions, type GossipDeliveryStatus, type GossipMessage, GossipProtocol, type GossipProtocolOptions, type GossipStats, MAX_BLOB_BYTES, MESH_SIGNAL_PAYLOAD_TYPE, MemoryServerRecordStore, NEGOTIATION_ACTIVE_ICE_DEADLINE_MS, NEGOTIATION_DEAD_TRANSPORT_DEADLINE_MS, NEGOTIATION_OFFER_DEADLINE_MS, PartialMesh, type PartialMeshConfig, type PartialMeshEvents, type PartialMeshRuntimeConfig, type PeerCapacityAdvertisement, type PeerCapacitySnapshot, type PeerConnection, type PeerGraphEdge, type PeerGraphNode, type PeerGraphSnapshot, type PeerPigeonCryptoEvents, type PeerPigeonCryptoOptions, PeerPigeonCryptoProtocol, type PeerPigeonKeyPair, PeerPigeonNode, type PeerPigeonNodeEvents, type PeerPigeonNodeMessage, type PeerPigeonNodeOptions, type PeerPigeonNodeStorageOptions, PeerPigeonStorage, type PeerPublicKey, RELAY_CANDIDATES, RELAY_SCORE_STORAGE_KEY, RELAY_SWITCH_MARGIN, RELAY_VIRTUAL_IDS, type RelayInfo, type RelayKind, type RelayMeasurement, RelayScoreBook, type RoomCipher, STORAGE_REPLICAS, STORAGE_SERVER_NETWORK, STORAGE_SERVER_ROLE, STORAGE_SERVER_ROOM, type ServerRecord, type ServerRecordStore, type SharedRelayScore, type SignalingRelayCandidate, type StorageChangeOrigin, type StorageEvents, type StorageOptions, type StoragePutOptions, type StorageRecord, type StorageRetrieveOptions, StorageServer, StorageServerLink, type StorageServerStats, type StorageSpace, type StorageSyncFilterContext, type StorageSyncOptions, type StorageUnsubscribe, blobAddress, chooseRelays, PartialMesh as default, directRelaySupported, discoverClosestSignalingServer, discoverClosestSignalingServers, discoverSignalingRelays, isHealthy, isMeshSignalPayload, openBlob, ownedRoomOf, rankSignalingServersByDistance, reachableFromThisPage, relayDisplayName, relayScore, roomRoutingKey, sealBlob, selectClosestSignalingServer, sha1Hex, validRoom };
|