@microsoft/terraform-cdk-constructs 1.0.0 → 1.2.0
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/.jsii +60999 -15780
- package/API.md +54947 -10610
- package/README.md +72 -36
- package/docs/monitoring-guide.md +206 -0
- package/docs/testing.md +84 -1
- package/lib/azure-actiongroup/index.d.ts +11 -0
- package/lib/azure-actiongroup/index.js +28 -0
- package/lib/azure-actiongroup/lib/action-group-schemas.d.ts +24 -0
- package/lib/azure-actiongroup/lib/action-group-schemas.js +201 -0
- package/lib/azure-actiongroup/lib/action-group.d.ts +312 -0
- package/lib/azure-actiongroup/lib/action-group.js +201 -0
- package/lib/azure-actiongroup/lib/index.d.ts +5 -0
- package/lib/azure-actiongroup/lib/index.js +22 -0
- package/lib/azure-actiongroup/test/action-group.integ.d.ts +9 -0
- package/lib/azure-actiongroup/test/action-group.integ.js +79 -0
- package/lib/azure-actiongroup/test/action-group.spec.d.ts +8 -0
- package/lib/azure-actiongroup/test/action-group.spec.js +602 -0
- package/lib/azure-activitylogalert/index.d.ts +11 -0
- package/lib/azure-activitylogalert/index.js +28 -0
- package/lib/azure-activitylogalert/lib/activity-log-alert-schemas.d.ts +24 -0
- package/lib/azure-activitylogalert/lib/activity-log-alert-schemas.js +182 -0
- package/lib/azure-activitylogalert/lib/activity-log-alert.d.ts +236 -0
- package/lib/azure-activitylogalert/lib/activity-log-alert.js +212 -0
- package/lib/azure-activitylogalert/lib/index.d.ts +5 -0
- package/lib/azure-activitylogalert/lib/index.js +22 -0
- package/lib/azure-activitylogalert/test/activity-log-alert.integ.d.ts +9 -0
- package/lib/azure-activitylogalert/test/activity-log-alert.integ.js +98 -0
- package/lib/azure-activitylogalert/test/activity-log-alert.spec.d.ts +9 -0
- package/lib/azure-activitylogalert/test/activity-log-alert.spec.js +1101 -0
- package/lib/azure-aks/index.d.ts +9 -0
- package/lib/azure-aks/index.js +28 -0
- package/lib/azure-aks/lib/aks-cluster-schemas.d.ts +505 -0
- package/lib/azure-aks/lib/aks-cluster-schemas.js +572 -0
- package/lib/azure-aks/lib/aks-cluster.d.ts +395 -0
- package/lib/azure-aks/lib/aks-cluster.js +489 -0
- package/lib/azure-aks/lib/index.d.ts +11 -0
- package/lib/azure-aks/lib/index.js +38 -0
- package/lib/azure-aks/test/aks-cluster.integ.d.ts +9 -0
- package/lib/azure-aks/test/aks-cluster.integ.js +260 -0
- package/lib/azure-aks/test/aks-cluster.spec.d.ts +8 -0
- package/lib/azure-aks/test/aks-cluster.spec.js +1396 -0
- package/lib/azure-diagnosticsettings/index.d.ts +7 -0
- package/lib/azure-diagnosticsettings/index.js +24 -0
- package/lib/azure-diagnosticsettings/lib/diagnostic-settings-schemas.d.ts +50 -0
- package/lib/azure-diagnosticsettings/lib/diagnostic-settings-schemas.js +207 -0
- package/lib/azure-diagnosticsettings/lib/diagnostic-settings.d.ts +193 -0
- package/lib/azure-diagnosticsettings/lib/diagnostic-settings.js +200 -0
- package/lib/azure-diagnosticsettings/lib/index.d.ts +8 -0
- package/lib/azure-diagnosticsettings/lib/index.js +25 -0
- package/lib/azure-diagnosticsettings/test/diagnostic-settings.spec.d.ts +8 -0
- package/lib/azure-diagnosticsettings/test/diagnostic-settings.spec.js +432 -0
- package/lib/azure-metricalert/index.d.ts +11 -0
- package/lib/azure-metricalert/index.js +28 -0
- package/lib/azure-metricalert/lib/index.d.ts +5 -0
- package/lib/azure-metricalert/lib/index.js +22 -0
- package/lib/azure-metricalert/lib/metric-alert-schemas.d.ts +24 -0
- package/lib/azure-metricalert/lib/metric-alert-schemas.js +242 -0
- package/lib/azure-metricalert/lib/metric-alert.d.ts +344 -0
- package/lib/azure-metricalert/lib/metric-alert.js +252 -0
- package/lib/azure-metricalert/test/metric-alert.integ.d.ts +9 -0
- package/lib/azure-metricalert/test/metric-alert.integ.js +123 -0
- package/lib/azure-metricalert/test/metric-alert.spec.d.ts +9 -0
- package/lib/azure-metricalert/test/metric-alert.spec.js +1266 -0
- package/lib/azure-networkinterface/index.d.ts +4 -0
- package/lib/azure-networkinterface/index.js +21 -0
- package/lib/azure-networkinterface/lib/index.d.ts +6 -0
- package/lib/azure-networkinterface/lib/index.js +22 -0
- package/lib/azure-networkinterface/lib/network-interface-schemas.d.ts +32 -0
- package/lib/azure-networkinterface/lib/network-interface-schemas.js +222 -0
- package/lib/azure-networkinterface/lib/network-interface.d.ts +265 -0
- package/lib/azure-networkinterface/lib/network-interface.js +228 -0
- package/lib/azure-networkinterface/test/network-interface.integ.d.ts +9 -0
- package/lib/azure-networkinterface/test/network-interface.integ.js +102 -0
- package/lib/azure-networkinterface/test/network-interface.spec.d.ts +8 -0
- package/lib/azure-networkinterface/test/network-interface.spec.js +655 -0
- package/lib/azure-networksecuritygroup/index.d.ts +6 -0
- package/lib/azure-networksecuritygroup/index.js +23 -0
- package/lib/azure-networksecuritygroup/lib/index.d.ts +5 -0
- package/lib/azure-networksecuritygroup/lib/index.js +16 -0
- package/lib/azure-networksecuritygroup/lib/network-security-group-schemas.d.ts +32 -0
- package/lib/azure-networksecuritygroup/lib/network-security-group-schemas.js +198 -0
- package/lib/azure-networksecuritygroup/lib/network-security-group.d.ts +268 -0
- package/lib/azure-networksecuritygroup/lib/network-security-group.js +248 -0
- package/lib/azure-networksecuritygroup/test/network-security-group.integ.d.ts +9 -0
- package/lib/azure-networksecuritygroup/test/network-security-group.integ.js +151 -0
- package/lib/azure-networksecuritygroup/test/network-security-group.spec.d.ts +8 -0
- package/lib/azure-networksecuritygroup/test/network-security-group.spec.js +652 -0
- package/lib/azure-publicipaddress/index.d.ts +6 -0
- package/lib/azure-publicipaddress/index.js +23 -0
- package/lib/azure-publicipaddress/lib/index.d.ts +9 -0
- package/lib/azure-publicipaddress/lib/index.js +19 -0
- package/lib/azure-publicipaddress/lib/public-ip-address-schemas.d.ts +32 -0
- package/lib/azure-publicipaddress/lib/public-ip-address-schemas.js +227 -0
- package/lib/azure-publicipaddress/lib/public-ip-address.d.ts +256 -0
- package/lib/azure-publicipaddress/lib/public-ip-address.js +267 -0
- package/lib/azure-publicipaddress/test/public-ip-address.integ.d.ts +9 -0
- package/lib/azure-publicipaddress/test/public-ip-address.integ.js +75 -0
- package/lib/azure-publicipaddress/test/public-ip-address.spec.d.ts +15 -0
- package/lib/azure-publicipaddress/test/public-ip-address.spec.js +498 -0
- package/lib/azure-resourcegroup/lib/resource-group.js +1 -1
- package/lib/azure-resourcegroup/test/resource-group.integ.js +23 -11
- package/lib/azure-storageaccount/lib/storage-account-schemas.d.ts +98 -0
- package/lib/azure-storageaccount/lib/storage-account-schemas.js +1 -1
- package/lib/azure-storageaccount/lib/storage-account.d.ts +38 -1
- package/lib/azure-storageaccount/lib/storage-account.js +138 -2
- package/lib/azure-storageaccount/test/storage-account.integ.js +91 -12
- package/lib/azure-subnet/index.d.ts +4 -0
- package/lib/azure-subnet/index.js +21 -0
- package/lib/azure-subnet/lib/index.d.ts +5 -0
- package/lib/azure-subnet/lib/index.js +22 -0
- package/lib/azure-subnet/lib/subnet-schemas.d.ts +32 -0
- package/lib/azure-subnet/lib/subnet-schemas.js +237 -0
- package/lib/azure-subnet/lib/subnet.d.ts +285 -0
- package/lib/azure-subnet/lib/subnet.js +254 -0
- package/lib/azure-subnet/test/subnet.integ.d.ts +11 -0
- package/lib/azure-subnet/test/subnet.integ.js +80 -0
- package/lib/azure-subnet/test/subnet.spec.d.ts +8 -0
- package/lib/azure-subnet/test/subnet.spec.js +396 -0
- package/lib/azure-virtualmachine/index.d.ts +7 -0
- package/lib/azure-virtualmachine/index.js +24 -0
- package/lib/azure-virtualmachine/lib/index.d.ts +11 -0
- package/lib/azure-virtualmachine/lib/index.js +38 -0
- package/lib/azure-virtualmachine/lib/virtual-machine-schemas.d.ts +327 -0
- package/lib/azure-virtualmachine/lib/virtual-machine-schemas.js +544 -0
- package/lib/azure-virtualmachine/lib/virtual-machine.d.ts +377 -0
- package/lib/azure-virtualmachine/lib/virtual-machine.js +462 -0
- package/lib/azure-virtualmachine/test/virtual-machine.integ.d.ts +9 -0
- package/lib/azure-virtualmachine/test/virtual-machine.integ.js +220 -0
- package/lib/azure-virtualmachine/test/virtual-machine.spec.d.ts +9 -0
- package/lib/azure-virtualmachine/test/virtual-machine.spec.js +1032 -0
- package/lib/azure-virtualnetwork/index.d.ts +10 -0
- package/lib/azure-virtualnetwork/index.js +28 -0
- package/lib/azure-virtualnetwork/lib/index.d.ts +9 -0
- package/lib/azure-virtualnetwork/lib/index.js +22 -0
- package/lib/azure-virtualnetwork/lib/virtual-network-schemas.d.ts +32 -0
- package/lib/azure-virtualnetwork/lib/virtual-network-schemas.js +236 -0
- package/lib/azure-virtualnetwork/lib/virtual-network.d.ts +213 -0
- package/lib/azure-virtualnetwork/lib/virtual-network.js +245 -0
- package/lib/azure-virtualnetwork/test/virtual-network.integ.d.ts +9 -0
- package/lib/azure-virtualnetwork/test/virtual-network.integ.js +91 -0
- package/lib/azure-virtualnetwork/test/virtual-network.spec.d.ts +8 -0
- package/lib/azure-virtualnetwork/test/virtual-network.spec.js +398 -0
- package/lib/azure-vmss/index.d.ts +6 -0
- package/lib/azure-vmss/index.js +23 -0
- package/lib/azure-vmss/lib/index.d.ts +9 -0
- package/lib/azure-vmss/lib/index.js +39 -0
- package/lib/azure-vmss/lib/virtual-machine-scale-set.d.ts +258 -0
- package/lib/azure-vmss/lib/virtual-machine-scale-set.js +503 -0
- package/lib/azure-vmss/lib/vmss-schemas.d.ts +472 -0
- package/lib/azure-vmss/lib/vmss-schemas.js +444 -0
- package/lib/azure-vmss/test/virtual-machine-scale-set.integ.d.ts +15 -0
- package/lib/azure-vmss/test/virtual-machine-scale-set.integ.js +261 -0
- package/lib/azure-vmss/test/virtual-machine-scale-set.spec.d.ts +8 -0
- package/lib/azure-vmss/test/virtual-machine-scale-set.spec.js +997 -0
- package/lib/core-azure/lib/azapi/azapi-resource.d.ts +95 -27
- package/lib/core-azure/lib/azapi/azapi-resource.js +95 -58
- package/lib/core-azure/lib/azapi/providers-azapi/data-azapi-client-config/index.d.ts +33 -21
- package/lib/core-azure/lib/azapi/providers-azapi/data-azapi-client-config/index.js +69 -27
- package/lib/core-azure/lib/azapi/providers-azapi/data-azapi-resource/index.d.ts +134 -120
- package/lib/core-azure/lib/azapi/providers-azapi/data-azapi-resource/index.js +209 -59
- package/lib/core-azure/lib/azapi/providers-azapi/data-azapi-resource-action/index.d.ts +141 -128
- package/lib/core-azure/lib/azapi/providers-azapi/data-azapi-resource-action/index.js +183 -36
- package/lib/core-azure/lib/azapi/providers-azapi/data-azapi-resource-id/index.d.ts +55 -43
- package/lib/core-azure/lib/azapi/providers-azapi/data-azapi-resource-id/index.js +94 -26
- package/lib/core-azure/lib/azapi/providers-azapi/data-azapi-resource-list/index.d.ts +129 -116
- package/lib/core-azure/lib/azapi/providers-azapi/data-azapi-resource-list/index.js +155 -32
- package/lib/core-azure/lib/azapi/providers-azapi/data-plane-resource/index.d.ts +187 -174
- package/lib/core-azure/lib/azapi/providers-azapi/data-plane-resource/index.js +267 -48
- package/lib/core-azure/lib/azapi/providers-azapi/index.d.ts +10 -10
- package/lib/core-azure/lib/azapi/providers-azapi/index.js +1 -1
- package/lib/core-azure/lib/azapi/providers-azapi/lazy-index.d.ts +0 -0
- package/lib/core-azure/lib/azapi/providers-azapi/lazy-index.js +13 -0
- package/lib/core-azure/lib/azapi/providers-azapi/provider/index.d.ts +174 -162
- package/lib/core-azure/lib/azapi/providers-azapi/provider/index.js +274 -14
- package/lib/core-azure/lib/azapi/providers-azapi/resource/index.d.ts +239 -225
- package/lib/core-azure/lib/azapi/providers-azapi/resource/index.js +360 -76
- package/lib/core-azure/lib/azapi/providers-azapi/resource-action/index.d.ts +163 -150
- package/lib/core-azure/lib/azapi/providers-azapi/resource-action/index.js +221 -46
- package/lib/core-azure/lib/azapi/providers-azapi/update-resource/index.d.ts +162 -149
- package/lib/core-azure/lib/azapi/providers-azapi/update-resource/index.js +249 -50
- package/lib/core-azure/lib/azapi/schema-mapper/schema-mapper.js +4 -2
- package/lib/core-azure/lib/version-manager/api-version-manager.js +1 -1
- package/lib/core-azure/lib/version-manager/interfaces/version-interfaces.js +7 -7
- package/lib/index.d.ts +37 -0
- package/lib/index.js +40 -2
- package/lib/testing/index.d.ts +92 -2
- package/lib/testing/index.js +258 -18
- package/lib/testing/lib/cleanup.d.ts +229 -0
- package/lib/testing/lib/cleanup.js +331 -0
- package/lib/testing/lib/metadata.d.ts +151 -0
- package/lib/testing/lib/metadata.js +180 -0
- package/lib/testing/lib/naming.d.ts +96 -0
- package/lib/testing/lib/naming.js +336 -0
- package/node_modules/uuid/LICENSE.md +9 -0
- package/node_modules/uuid/README.md +510 -0
- package/node_modules/uuid/dist/cjs/index.d.ts +15 -0
- package/node_modules/uuid/dist/cjs/index.js +31 -0
- package/node_modules/uuid/dist/cjs/max.d.ts +2 -0
- package/node_modules/uuid/dist/cjs/max.js +3 -0
- package/node_modules/uuid/dist/cjs/md5.d.ts +4 -0
- package/node_modules/uuid/dist/cjs/md5.js +13 -0
- package/node_modules/uuid/dist/cjs/native.d.ts +6 -0
- package/node_modules/uuid/dist/cjs/native.js +4 -0
- package/node_modules/uuid/dist/cjs/nil.d.ts +2 -0
- package/node_modules/uuid/dist/cjs/nil.js +3 -0
- package/node_modules/uuid/dist/cjs/package.json +1 -0
- package/node_modules/uuid/dist/cjs/parse.d.ts +2 -0
- package/node_modules/uuid/dist/cjs/parse.js +11 -0
- package/node_modules/uuid/dist/cjs/regex.d.ts +2 -0
- package/node_modules/uuid/dist/cjs/regex.js +3 -0
- package/node_modules/uuid/dist/cjs/rng.d.ts +1 -0
- package/node_modules/uuid/dist/cjs/rng.js +13 -0
- package/node_modules/uuid/dist/cjs/sha1.d.ts +4 -0
- package/node_modules/uuid/dist/cjs/sha1.js +13 -0
- package/node_modules/uuid/dist/cjs/stringify.d.ts +3 -0
- package/node_modules/uuid/dist/cjs/stringify.js +39 -0
- package/node_modules/uuid/dist/cjs/types.d.ts +21 -0
- package/node_modules/uuid/dist/cjs/types.js +2 -0
- package/node_modules/uuid/dist/cjs/uuid-bin.d.ts +1 -0
- package/node_modules/uuid/dist/cjs/uuid-bin.js +72 -0
- package/node_modules/uuid/dist/cjs/v1.d.ts +11 -0
- package/node_modules/uuid/dist/cjs/v1.js +87 -0
- package/node_modules/uuid/dist/cjs/v1ToV6.d.ts +2 -0
- package/node_modules/uuid/dist/cjs/v1ToV6.js +13 -0
- package/node_modules/uuid/dist/cjs/v3.d.ts +9 -0
- package/node_modules/uuid/dist/cjs/v3.js +14 -0
- package/node_modules/uuid/dist/cjs/v35.d.ts +7 -0
- package/node_modules/uuid/dist/cjs/v35.js +41 -0
- package/node_modules/uuid/dist/cjs/v4.d.ts +4 -0
- package/node_modules/uuid/dist/cjs/v4.js +29 -0
- package/node_modules/uuid/dist/cjs/v5.d.ts +9 -0
- package/node_modules/uuid/dist/cjs/v5.js +14 -0
- package/node_modules/uuid/dist/cjs/v6.d.ts +4 -0
- package/node_modules/uuid/dist/cjs/v6.js +19 -0
- package/node_modules/uuid/dist/cjs/v6ToV1.d.ts +2 -0
- package/node_modules/uuid/dist/cjs/v6ToV1.js +13 -0
- package/node_modules/uuid/dist/cjs/v7.d.ts +9 -0
- package/node_modules/uuid/dist/cjs/v7.js +69 -0
- package/node_modules/uuid/dist/cjs/validate.d.ts +2 -0
- package/node_modules/uuid/dist/cjs/validate.js +7 -0
- package/node_modules/uuid/dist/cjs/version.d.ts +2 -0
- package/node_modules/uuid/dist/cjs/version.js +10 -0
- package/node_modules/uuid/dist/cjs-browser/index.d.ts +15 -0
- package/node_modules/uuid/dist/cjs-browser/index.js +31 -0
- package/node_modules/uuid/dist/cjs-browser/max.d.ts +2 -0
- package/node_modules/uuid/dist/cjs-browser/max.js +3 -0
- package/node_modules/uuid/dist/cjs-browser/md5.d.ts +2 -0
- package/node_modules/uuid/dist/cjs-browser/md5.js +137 -0
- package/node_modules/uuid/dist/cjs-browser/native.d.ts +4 -0
- package/node_modules/uuid/dist/cjs-browser/native.js +4 -0
- package/node_modules/uuid/dist/cjs-browser/nil.d.ts +2 -0
- package/node_modules/uuid/dist/cjs-browser/nil.js +3 -0
- package/node_modules/uuid/dist/cjs-browser/package.json +1 -0
- package/node_modules/uuid/dist/cjs-browser/parse.d.ts +2 -0
- package/node_modules/uuid/dist/cjs-browser/parse.js +11 -0
- package/node_modules/uuid/dist/cjs-browser/regex.d.ts +2 -0
- package/node_modules/uuid/dist/cjs-browser/regex.js +3 -0
- package/node_modules/uuid/dist/cjs-browser/rng.d.ts +1 -0
- package/node_modules/uuid/dist/cjs-browser/rng.js +14 -0
- package/node_modules/uuid/dist/cjs-browser/sha1.d.ts +2 -0
- package/node_modules/uuid/dist/cjs-browser/sha1.js +72 -0
- package/node_modules/uuid/dist/cjs-browser/stringify.d.ts +3 -0
- package/node_modules/uuid/dist/cjs-browser/stringify.js +39 -0
- package/node_modules/uuid/dist/cjs-browser/types.d.ts +21 -0
- package/node_modules/uuid/dist/cjs-browser/types.js +2 -0
- package/node_modules/uuid/dist/cjs-browser/uuid-bin.d.ts +1 -0
- package/node_modules/uuid/dist/cjs-browser/uuid-bin.js +72 -0
- package/node_modules/uuid/dist/cjs-browser/v1.d.ts +11 -0
- package/node_modules/uuid/dist/cjs-browser/v1.js +87 -0
- package/node_modules/uuid/dist/cjs-browser/v1ToV6.d.ts +2 -0
- package/node_modules/uuid/dist/cjs-browser/v1ToV6.js +13 -0
- package/node_modules/uuid/dist/cjs-browser/v3.d.ts +9 -0
- package/node_modules/uuid/dist/cjs-browser/v3.js +14 -0
- package/node_modules/uuid/dist/cjs-browser/v35.d.ts +7 -0
- package/node_modules/uuid/dist/cjs-browser/v35.js +41 -0
- package/node_modules/uuid/dist/cjs-browser/v4.d.ts +4 -0
- package/node_modules/uuid/dist/cjs-browser/v4.js +29 -0
- package/node_modules/uuid/dist/cjs-browser/v5.d.ts +9 -0
- package/node_modules/uuid/dist/cjs-browser/v5.js +14 -0
- package/node_modules/uuid/dist/cjs-browser/v6.d.ts +4 -0
- package/node_modules/uuid/dist/cjs-browser/v6.js +19 -0
- package/node_modules/uuid/dist/cjs-browser/v6ToV1.d.ts +2 -0
- package/node_modules/uuid/dist/cjs-browser/v6ToV1.js +13 -0
- package/node_modules/uuid/dist/cjs-browser/v7.d.ts +9 -0
- package/node_modules/uuid/dist/cjs-browser/v7.js +69 -0
- package/node_modules/uuid/dist/cjs-browser/validate.d.ts +2 -0
- package/node_modules/uuid/dist/cjs-browser/validate.js +7 -0
- package/node_modules/uuid/dist/cjs-browser/version.d.ts +2 -0
- package/node_modules/uuid/dist/cjs-browser/version.js +10 -0
- package/node_modules/uuid/dist/esm/bin/uuid +2 -0
- package/node_modules/uuid/dist/esm/index.d.ts +15 -0
- package/node_modules/uuid/dist/esm/index.js +14 -0
- package/node_modules/uuid/dist/esm/max.d.ts +2 -0
- package/node_modules/uuid/dist/esm/max.js +1 -0
- package/node_modules/uuid/dist/esm/md5.d.ts +4 -0
- package/node_modules/uuid/dist/esm/md5.js +11 -0
- package/node_modules/uuid/dist/esm/native.d.ts +6 -0
- package/node_modules/uuid/dist/esm/native.js +2 -0
- package/node_modules/uuid/dist/esm/nil.d.ts +2 -0
- package/node_modules/uuid/dist/esm/nil.js +1 -0
- package/node_modules/uuid/dist/esm/parse.d.ts +2 -0
- package/node_modules/uuid/dist/esm/parse.js +9 -0
- package/node_modules/uuid/dist/esm/regex.d.ts +2 -0
- package/node_modules/uuid/dist/esm/regex.js +1 -0
- package/node_modules/uuid/dist/esm/rng.d.ts +1 -0
- package/node_modules/uuid/dist/esm/rng.js +10 -0
- package/node_modules/uuid/dist/esm/sha1.d.ts +4 -0
- package/node_modules/uuid/dist/esm/sha1.js +11 -0
- package/node_modules/uuid/dist/esm/stringify.d.ts +3 -0
- package/node_modules/uuid/dist/esm/stringify.js +35 -0
- package/node_modules/uuid/dist/esm/types.d.ts +21 -0
- package/node_modules/uuid/dist/esm/types.js +1 -0
- package/node_modules/uuid/dist/esm/uuid-bin.d.ts +1 -0
- package/node_modules/uuid/dist/esm/uuid-bin.js +70 -0
- package/node_modules/uuid/dist/esm/v1.d.ts +11 -0
- package/node_modules/uuid/dist/esm/v1.js +83 -0
- package/node_modules/uuid/dist/esm/v1ToV6.d.ts +2 -0
- package/node_modules/uuid/dist/esm/v1ToV6.js +10 -0
- package/node_modules/uuid/dist/esm/v3.d.ts +9 -0
- package/node_modules/uuid/dist/esm/v3.js +9 -0
- package/node_modules/uuid/dist/esm/v35.d.ts +7 -0
- package/node_modules/uuid/dist/esm/v35.js +36 -0
- package/node_modules/uuid/dist/esm/v4.d.ts +4 -0
- package/node_modules/uuid/dist/esm/v4.js +27 -0
- package/node_modules/uuid/dist/esm/v5.d.ts +9 -0
- package/node_modules/uuid/dist/esm/v5.js +9 -0
- package/node_modules/uuid/dist/esm/v6.d.ts +4 -0
- package/node_modules/uuid/dist/esm/v6.js +17 -0
- package/node_modules/uuid/dist/esm/v6ToV1.d.ts +2 -0
- package/node_modules/uuid/dist/esm/v6ToV1.js +10 -0
- package/node_modules/uuid/dist/esm/v7.d.ts +9 -0
- package/node_modules/uuid/dist/esm/v7.js +65 -0
- package/node_modules/uuid/dist/esm/validate.d.ts +2 -0
- package/node_modules/uuid/dist/esm/validate.js +5 -0
- package/node_modules/uuid/dist/esm/version.d.ts +2 -0
- package/node_modules/uuid/dist/esm/version.js +8 -0
- package/node_modules/uuid/dist/esm-browser/index.d.ts +15 -0
- package/node_modules/uuid/dist/esm-browser/index.js +14 -0
- package/node_modules/uuid/dist/esm-browser/max.d.ts +2 -0
- package/node_modules/uuid/dist/esm-browser/max.js +1 -0
- package/node_modules/uuid/dist/esm-browser/md5.d.ts +2 -0
- package/node_modules/uuid/dist/esm-browser/md5.js +135 -0
- package/node_modules/uuid/dist/esm-browser/native.d.ts +4 -0
- package/node_modules/uuid/dist/esm-browser/native.js +2 -0
- package/node_modules/uuid/dist/esm-browser/nil.d.ts +2 -0
- package/node_modules/uuid/dist/esm-browser/nil.js +1 -0
- package/node_modules/uuid/dist/esm-browser/parse.d.ts +2 -0
- package/node_modules/uuid/dist/esm-browser/parse.js +9 -0
- package/node_modules/uuid/dist/esm-browser/regex.d.ts +2 -0
- package/node_modules/uuid/dist/esm-browser/regex.js +1 -0
- package/node_modules/uuid/dist/esm-browser/rng.d.ts +1 -0
- package/node_modules/uuid/dist/esm-browser/rng.js +11 -0
- package/node_modules/uuid/dist/esm-browser/sha1.d.ts +2 -0
- package/node_modules/uuid/dist/esm-browser/sha1.js +70 -0
- package/node_modules/uuid/dist/esm-browser/stringify.d.ts +3 -0
- package/node_modules/uuid/dist/esm-browser/stringify.js +35 -0
- package/node_modules/uuid/dist/esm-browser/types.d.ts +21 -0
- package/node_modules/uuid/dist/esm-browser/types.js +1 -0
- package/node_modules/uuid/dist/esm-browser/uuid-bin.d.ts +1 -0
- package/node_modules/uuid/dist/esm-browser/uuid-bin.js +70 -0
- package/node_modules/uuid/dist/esm-browser/v1.d.ts +11 -0
- package/node_modules/uuid/dist/esm-browser/v1.js +83 -0
- package/node_modules/uuid/dist/esm-browser/v1ToV6.d.ts +2 -0
- package/node_modules/uuid/dist/esm-browser/v1ToV6.js +10 -0
- package/node_modules/uuid/dist/esm-browser/v3.d.ts +9 -0
- package/node_modules/uuid/dist/esm-browser/v3.js +9 -0
- package/node_modules/uuid/dist/esm-browser/v35.d.ts +7 -0
- package/node_modules/uuid/dist/esm-browser/v35.js +36 -0
- package/node_modules/uuid/dist/esm-browser/v4.d.ts +4 -0
- package/node_modules/uuid/dist/esm-browser/v4.js +27 -0
- package/node_modules/uuid/dist/esm-browser/v5.d.ts +9 -0
- package/node_modules/uuid/dist/esm-browser/v5.js +9 -0
- package/node_modules/uuid/dist/esm-browser/v6.d.ts +4 -0
- package/node_modules/uuid/dist/esm-browser/v6.js +17 -0
- package/node_modules/uuid/dist/esm-browser/v6ToV1.d.ts +2 -0
- package/node_modules/uuid/dist/esm-browser/v6ToV1.js +10 -0
- package/node_modules/uuid/dist/esm-browser/v7.d.ts +9 -0
- package/node_modules/uuid/dist/esm-browser/v7.js +65 -0
- package/node_modules/uuid/dist/esm-browser/validate.d.ts +2 -0
- package/node_modules/uuid/dist/esm-browser/validate.js +5 -0
- package/node_modules/uuid/dist/esm-browser/version.d.ts +2 -0
- package/node_modules/uuid/dist/esm-browser/version.js +8 -0
- package/node_modules/uuid/package.json +132 -0
- package/package.json +17 -12
- package/scripts/cleanup-test-resources.ts +369 -0
|
@@ -0,0 +1,510 @@
|
|
|
1
|
+
<!--
|
|
2
|
+
-- This file is auto-generated from README_js.md. Changes should be made there.
|
|
3
|
+
-->
|
|
4
|
+
|
|
5
|
+
# uuid [](https://github.com/uuidjs/uuid/actions?query=workflow%3ACI) [](https://github.com/uuidjs/uuid/actions/workflows/browser.yml)
|
|
6
|
+
|
|
7
|
+
For the creation of [RFC9562](https://www.rfc-editor.org/rfc/rfc9562.html) (formerly [RFC4122](https://www.rfc-editor.org/rfc/rfc4122.html)) UUIDs
|
|
8
|
+
|
|
9
|
+
- **Complete** - Support for all RFC9562 UUID versions
|
|
10
|
+
- **Cross-platform** - Support for...
|
|
11
|
+
- ESM & Common JS
|
|
12
|
+
- [Typescript](#support)
|
|
13
|
+
- [Chrome, Safari, Firefox, and Edge](#support)
|
|
14
|
+
- [NodeJS](#support)
|
|
15
|
+
- [React Native / Expo](#react-native--expo)
|
|
16
|
+
- **Secure** - Uses modern `crypto` API for random values
|
|
17
|
+
- **Compact** - Zero-dependency, [tree-shakable](https://developer.mozilla.org/en-US/docs/Glossary/Tree_shaking)
|
|
18
|
+
- **CLI** - [`uuid` command line](#command-line) utility
|
|
19
|
+
|
|
20
|
+
<!-- prettier-ignore -->
|
|
21
|
+
> [!NOTE]
|
|
22
|
+
> `uuid@11` is now available: See the [CHANGELOG](./CHANGELOG.md) for details. TL;DR:
|
|
23
|
+
> * TypeScript support is now included (remove `@types/uuid` from your dependencies)
|
|
24
|
+
> * Subtle changes to how the `options` arg is interpreted for `v1()`, `v6()`, and `v7()`. [See details](#options-handling-for-timestamp-uuids)
|
|
25
|
+
> * Binary UUIDs are now `Uint8Array`s. (May impact callers of `parse()`, `stringify()`, or that pass an `option#buf` argument to `v1()`-`v7()`.)
|
|
26
|
+
|
|
27
|
+
## Quickstart
|
|
28
|
+
|
|
29
|
+
**1. Install**
|
|
30
|
+
|
|
31
|
+
```shell
|
|
32
|
+
npm install uuid
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
**2. Create a UUID**
|
|
36
|
+
|
|
37
|
+
ESM-syntax (must use named exports):
|
|
38
|
+
|
|
39
|
+
```javascript
|
|
40
|
+
import { v4 as uuidv4 } from 'uuid';
|
|
41
|
+
uuidv4(); // ⇨ '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d'
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
... CommonJS:
|
|
45
|
+
|
|
46
|
+
```javascript
|
|
47
|
+
const { v4: uuidv4 } = require('uuid');
|
|
48
|
+
uuidv4(); // ⇨ '1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed'
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
For timestamp UUIDs, namespace UUIDs, and other options read on ...
|
|
52
|
+
|
|
53
|
+
## API Summary
|
|
54
|
+
|
|
55
|
+
| | | |
|
|
56
|
+
| --- | --- | --- |
|
|
57
|
+
| [`uuid.NIL`](#uuidnil) | The nil UUID string (all zeros) | New in `uuid@8.3` |
|
|
58
|
+
| [`uuid.MAX`](#uuidmax) | The max UUID string (all ones) | New in `uuid@9.1` |
|
|
59
|
+
| [`uuid.parse()`](#uuidparsestr) | Convert UUID string to array of bytes | New in `uuid@8.3` |
|
|
60
|
+
| [`uuid.stringify()`](#uuidstringifyarr-offset) | Convert array of bytes to UUID string | New in `uuid@8.3` |
|
|
61
|
+
| [`uuid.v1()`](#uuidv1options-buffer-offset) | Create a version 1 (timestamp) UUID | |
|
|
62
|
+
| [`uuid.v1ToV6()`](#uuidv1tov6uuid) | Create a version 6 UUID from a version 1 UUID | New in `uuid@10` |
|
|
63
|
+
| [`uuid.v3()`](#uuidv3name-namespace-buffer-offset) | Create a version 3 (namespace w/ MD5) UUID | |
|
|
64
|
+
| [`uuid.v4()`](#uuidv4options-buffer-offset) | Create a version 4 (random) UUID | |
|
|
65
|
+
| [`uuid.v5()`](#uuidv5name-namespace-buffer-offset) | Create a version 5 (namespace w/ SHA-1) UUID | |
|
|
66
|
+
| [`uuid.v6()`](#uuidv6options-buffer-offset) | Create a version 6 (timestamp, reordered) UUID | New in `uuid@10` |
|
|
67
|
+
| [`uuid.v6ToV1()`](#uuidv6tov1uuid) | Create a version 1 UUID from a version 6 UUID | New in `uuid@10` |
|
|
68
|
+
| [`uuid.v7()`](#uuidv7options-buffer-offset) | Create a version 7 (Unix Epoch time-based) UUID | New in `uuid@10` |
|
|
69
|
+
| ~~[`uuid.v8()`](#uuidv8)~~ | "Intentionally left blank" | |
|
|
70
|
+
| [`uuid.validate()`](#uuidvalidatestr) | Test a string to see if it is a valid UUID | New in `uuid@8.3` |
|
|
71
|
+
| [`uuid.version()`](#uuidversionstr) | Detect RFC version of a UUID | New in `uuid@8.3` |
|
|
72
|
+
|
|
73
|
+
## API
|
|
74
|
+
|
|
75
|
+
### uuid.NIL
|
|
76
|
+
|
|
77
|
+
The nil UUID string (all zeros).
|
|
78
|
+
|
|
79
|
+
Example:
|
|
80
|
+
|
|
81
|
+
```javascript
|
|
82
|
+
import { NIL as NIL_UUID } from 'uuid';
|
|
83
|
+
|
|
84
|
+
NIL_UUID; // ⇨ '00000000-0000-0000-0000-000000000000'
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### uuid.MAX
|
|
88
|
+
|
|
89
|
+
The max UUID string (all ones).
|
|
90
|
+
|
|
91
|
+
Example:
|
|
92
|
+
|
|
93
|
+
```javascript
|
|
94
|
+
import { MAX as MAX_UUID } from 'uuid';
|
|
95
|
+
|
|
96
|
+
MAX_UUID; // ⇨ 'ffffffff-ffff-ffff-ffff-ffffffffffff'
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### uuid.parse(str)
|
|
100
|
+
|
|
101
|
+
Convert UUID string to array of bytes
|
|
102
|
+
|
|
103
|
+
| | |
|
|
104
|
+
| --------- | ---------------------------------------- |
|
|
105
|
+
| `str` | A valid UUID `String` |
|
|
106
|
+
| _returns_ | `Uint8Array[16]` |
|
|
107
|
+
| _throws_ | `TypeError` if `str` is not a valid UUID |
|
|
108
|
+
|
|
109
|
+
<!-- prettier-ignore -->
|
|
110
|
+
> [!NOTE]
|
|
111
|
+
> Ordering of values in the byte arrays used by `parse()` and `stringify()` follows the left ↠ right order of hex-pairs in UUID strings. As shown in the example below.
|
|
112
|
+
|
|
113
|
+
Example:
|
|
114
|
+
|
|
115
|
+
```javascript
|
|
116
|
+
import { parse as uuidParse } from 'uuid';
|
|
117
|
+
|
|
118
|
+
// Parse a UUID
|
|
119
|
+
uuidParse('6ec0bd7f-11c0-43da-975e-2a8ad9ebae0b'); // ⇨
|
|
120
|
+
// Uint8Array(16) [
|
|
121
|
+
// 110, 192, 189, 127, 17,
|
|
122
|
+
// 192, 67, 218, 151, 94,
|
|
123
|
+
// 42, 138, 217, 235, 174,
|
|
124
|
+
// 11
|
|
125
|
+
// ]
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
### uuid.stringify(arr[, offset])
|
|
129
|
+
|
|
130
|
+
Convert array of bytes to UUID string
|
|
131
|
+
|
|
132
|
+
| | |
|
|
133
|
+
| -------------- | ---------------------------------------------------------------------------- |
|
|
134
|
+
| `arr` | `Array`-like collection of 16 values (starting from `offset`) between 0-255. |
|
|
135
|
+
| [`offset` = 0] | `Number` Starting index in the Array |
|
|
136
|
+
| _returns_ | `String` |
|
|
137
|
+
| _throws_ | `TypeError` if a valid UUID string cannot be generated |
|
|
138
|
+
|
|
139
|
+
<!-- prettier-ignore -->
|
|
140
|
+
> [!NOTE]
|
|
141
|
+
> Ordering of values in the byte arrays used by `parse()` and `stringify()` follows the left ↠ right order of hex-pairs in UUID strings. As shown in the example below.
|
|
142
|
+
|
|
143
|
+
Example:
|
|
144
|
+
|
|
145
|
+
```javascript
|
|
146
|
+
import { stringify as uuidStringify } from 'uuid';
|
|
147
|
+
|
|
148
|
+
const uuidBytes = Uint8Array.of(
|
|
149
|
+
0x6e,
|
|
150
|
+
0xc0,
|
|
151
|
+
0xbd,
|
|
152
|
+
0x7f,
|
|
153
|
+
0x11,
|
|
154
|
+
0xc0,
|
|
155
|
+
0x43,
|
|
156
|
+
0xda,
|
|
157
|
+
0x97,
|
|
158
|
+
0x5e,
|
|
159
|
+
0x2a,
|
|
160
|
+
0x8a,
|
|
161
|
+
0xd9,
|
|
162
|
+
0xeb,
|
|
163
|
+
0xae,
|
|
164
|
+
0x0b
|
|
165
|
+
);
|
|
166
|
+
|
|
167
|
+
uuidStringify(uuidBytes); // ⇨ '6ec0bd7f-11c0-43da-975e-2a8ad9ebae0b'
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
### uuid.v1([options[, buffer[, offset]]])
|
|
171
|
+
|
|
172
|
+
Create an RFC version 1 (timestamp) UUID
|
|
173
|
+
|
|
174
|
+
| | |
|
|
175
|
+
| --- | --- |
|
|
176
|
+
| [`options`] | `Object` with one or more of the following properties: |
|
|
177
|
+
| [`options.node = (random)` ] | RFC "node" field as an `Array[6]` of byte values (per 4.1.6) |
|
|
178
|
+
| [`options.clockseq = (random)`] | RFC "clock sequence" as a `Number` between 0 - 0x3fff |
|
|
179
|
+
| [`options.msecs = (current time)`] | RFC "timestamp" field (`Number` of milliseconds, unix epoch) |
|
|
180
|
+
| [`options.nsecs = 0`] | RFC "timestamp" field (`Number` of nanoseconds to add to `msecs`, should be 0-10,000) |
|
|
181
|
+
| [`options.random = (random)`] | `Array` of 16 random bytes (0-255) used to generate other fields, above |
|
|
182
|
+
| [`options.rng`] | Alternative to `options.random`, a `Function` that returns an `Array` of 16 random bytes (0-255) |
|
|
183
|
+
| [`buffer`] | `Uint8Array` or `Uint8Array` subtype (e.g. Node.js `Buffer`). If provided, binary UUID is written into the array, starting at `offset` |
|
|
184
|
+
| [`offset` = 0] | `Number` Index to start writing UUID bytes in `buffer` |
|
|
185
|
+
| _returns_ | UUID `String` if no `buffer` is specified, otherwise returns `buffer` |
|
|
186
|
+
| _throws_ | `Error` if more than 10M UUIDs/sec are requested |
|
|
187
|
+
|
|
188
|
+
<!-- prettier-ignore -->
|
|
189
|
+
> [!NOTE]
|
|
190
|
+
> The default [node id](https://datatracker.ietf.org/doc/html/rfc9562#section-5.1) (the last 12 digits in the UUID) is generated once, randomly, on process startup, and then remains unchanged for the duration of the process.
|
|
191
|
+
|
|
192
|
+
<!-- prettier-ignore -->
|
|
193
|
+
> [!NOTE]
|
|
194
|
+
> `options.random` and `options.rng` are only meaningful on the very first call to `v1()`, where they may be passed to initialize the internal `node` and `clockseq` fields.
|
|
195
|
+
|
|
196
|
+
Example:
|
|
197
|
+
|
|
198
|
+
```javascript
|
|
199
|
+
import { v1 as uuidv1 } from 'uuid';
|
|
200
|
+
|
|
201
|
+
uuidv1(); // ⇨ '2c5ea4c0-4067-11e9-9bdd-2b0d7b3dcb6d'
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
Example using `options`:
|
|
205
|
+
|
|
206
|
+
```javascript
|
|
207
|
+
import { v1 as uuidv1 } from 'uuid';
|
|
208
|
+
|
|
209
|
+
const options = {
|
|
210
|
+
node: Uint8Array.of(0x01, 0x23, 0x45, 0x67, 0x89, 0xab),
|
|
211
|
+
clockseq: 0x1234,
|
|
212
|
+
msecs: new Date('2011-11-01').getTime(),
|
|
213
|
+
nsecs: 5678,
|
|
214
|
+
};
|
|
215
|
+
uuidv1(options); // ⇨ '710b962e-041c-11e1-9234-0123456789ab'
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
### uuid.v1ToV6(uuid)
|
|
219
|
+
|
|
220
|
+
Convert a UUID from version 1 to version 6
|
|
221
|
+
|
|
222
|
+
```javascript
|
|
223
|
+
import { v1ToV6 } from 'uuid';
|
|
224
|
+
|
|
225
|
+
v1ToV6('92f62d9e-22c4-11ef-97e9-325096b39f47'); // ⇨ '1ef22c49-2f62-6d9e-97e9-325096b39f47'
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
### uuid.v3(name, namespace[, buffer[, offset]])
|
|
229
|
+
|
|
230
|
+
Create an RFC version 3 (namespace w/ MD5) UUID
|
|
231
|
+
|
|
232
|
+
API is identical to `v5()`, but uses "v3" instead.
|
|
233
|
+
|
|
234
|
+
<!-- prettier-ignore -->
|
|
235
|
+
> [!IMPORTANT]
|
|
236
|
+
> Per the RFC, "_If backward compatibility is not an issue, SHA-1 [Version 5] is preferred_."
|
|
237
|
+
|
|
238
|
+
### uuid.v4([options[, buffer[, offset]]])
|
|
239
|
+
|
|
240
|
+
Create an RFC version 4 (random) UUID
|
|
241
|
+
|
|
242
|
+
| | |
|
|
243
|
+
| --- | --- |
|
|
244
|
+
| [`options`] | `Object` with one or more of the following properties: |
|
|
245
|
+
| [`options.random`] | `Array` of 16 random bytes (0-255) |
|
|
246
|
+
| [`options.rng`] | Alternative to `options.random`, a `Function` that returns an `Array` of 16 random bytes (0-255) |
|
|
247
|
+
| [`buffer`] | `Uint8Array` or `Uint8Array` subtype (e.g. Node.js `Buffer`). If provided, binary UUID is written into the array, starting at `offset` |
|
|
248
|
+
| [`offset` = 0] | `Number` Index to start writing UUID bytes in `buffer` |
|
|
249
|
+
| _returns_ | UUID `String` if no `buffer` is specified, otherwise returns `buffer` |
|
|
250
|
+
|
|
251
|
+
Example:
|
|
252
|
+
|
|
253
|
+
```javascript
|
|
254
|
+
import { v4 as uuidv4 } from 'uuid';
|
|
255
|
+
|
|
256
|
+
uuidv4(); // ⇨ '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d'
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
Example using predefined `random` values:
|
|
260
|
+
|
|
261
|
+
```javascript
|
|
262
|
+
import { v4 as uuidv4 } from 'uuid';
|
|
263
|
+
|
|
264
|
+
const v4options = {
|
|
265
|
+
random: Uint8Array.of(
|
|
266
|
+
0x10,
|
|
267
|
+
0x91,
|
|
268
|
+
0x56,
|
|
269
|
+
0xbe,
|
|
270
|
+
0xc4,
|
|
271
|
+
0xfb,
|
|
272
|
+
0xc1,
|
|
273
|
+
0xea,
|
|
274
|
+
0x71,
|
|
275
|
+
0xb4,
|
|
276
|
+
0xef,
|
|
277
|
+
0xe1,
|
|
278
|
+
0x67,
|
|
279
|
+
0x1c,
|
|
280
|
+
0x58,
|
|
281
|
+
0x36
|
|
282
|
+
),
|
|
283
|
+
};
|
|
284
|
+
uuidv4(v4options); // ⇨ '109156be-c4fb-41ea-b1b4-efe1671c5836'
|
|
285
|
+
```
|
|
286
|
+
|
|
287
|
+
### uuid.v5(name, namespace[, buffer[, offset]])
|
|
288
|
+
|
|
289
|
+
Create an RFC version 5 (namespace w/ SHA-1) UUID
|
|
290
|
+
|
|
291
|
+
| | |
|
|
292
|
+
| --- | --- |
|
|
293
|
+
| `name` | `String \| Array` |
|
|
294
|
+
| `namespace` | `String \| Array[16]` Namespace UUID |
|
|
295
|
+
| [`buffer`] | `Uint8Array` or `Uint8Array` subtype (e.g. Node.js `Buffer`). If provided, binary UUID is written into the array, starting at `offset` |
|
|
296
|
+
| [`offset` = 0] | `Number` Index to start writing UUID bytes in `buffer` |
|
|
297
|
+
| _returns_ | UUID `String` if no `buffer` is specified, otherwise returns `buffer` |
|
|
298
|
+
|
|
299
|
+
<!-- prettier-ignore -->
|
|
300
|
+
> [!NOTE]
|
|
301
|
+
> The RFC `DNS` and `URL` namespaces are available as `v5.DNS` and `v5.URL`.
|
|
302
|
+
|
|
303
|
+
Example with custom namespace:
|
|
304
|
+
|
|
305
|
+
```javascript
|
|
306
|
+
import { v5 as uuidv5 } from 'uuid';
|
|
307
|
+
|
|
308
|
+
// Define a custom namespace. Readers, create your own using something like
|
|
309
|
+
// https://www.uuidgenerator.net/
|
|
310
|
+
const MY_NAMESPACE = '1b671a64-40d5-491e-99b0-da01ff1f3341';
|
|
311
|
+
|
|
312
|
+
uuidv5('Hello, World!', MY_NAMESPACE); // ⇨ '630eb68f-e0fa-5ecc-887a-7c7a62614681'
|
|
313
|
+
```
|
|
314
|
+
|
|
315
|
+
Example with RFC `URL` namespace:
|
|
316
|
+
|
|
317
|
+
```javascript
|
|
318
|
+
import { v5 as uuidv5 } from 'uuid';
|
|
319
|
+
|
|
320
|
+
uuidv5('https://www.w3.org/', uuidv5.URL); // ⇨ 'c106a26a-21bb-5538-8bf2-57095d1976c1'
|
|
321
|
+
```
|
|
322
|
+
|
|
323
|
+
### uuid.v6([options[, buffer[, offset]]])
|
|
324
|
+
|
|
325
|
+
Create an RFC version 6 (timestamp, reordered) UUID
|
|
326
|
+
|
|
327
|
+
This method takes the same arguments as uuid.v1().
|
|
328
|
+
|
|
329
|
+
```javascript
|
|
330
|
+
import { v6 as uuidv6 } from 'uuid';
|
|
331
|
+
|
|
332
|
+
uuidv6(); // ⇨ '1e940672-c5ea-64c0-9b5d-ab8dfbbd4bed'
|
|
333
|
+
```
|
|
334
|
+
|
|
335
|
+
Example using `options`:
|
|
336
|
+
|
|
337
|
+
```javascript
|
|
338
|
+
import { v6 as uuidv6 } from 'uuid';
|
|
339
|
+
|
|
340
|
+
const options = {
|
|
341
|
+
node: [0x01, 0x23, 0x45, 0x67, 0x89, 0xab],
|
|
342
|
+
clockseq: 0x1234,
|
|
343
|
+
msecs: new Date('2011-11-01').getTime(),
|
|
344
|
+
nsecs: 5678,
|
|
345
|
+
};
|
|
346
|
+
uuidv6(options); // ⇨ '1e1041c7-10b9-662e-9234-0123456789ab'
|
|
347
|
+
```
|
|
348
|
+
|
|
349
|
+
### uuid.v6ToV1(uuid)
|
|
350
|
+
|
|
351
|
+
Convert a UUID from version 6 to version 1
|
|
352
|
+
|
|
353
|
+
```javascript
|
|
354
|
+
import { v6ToV1 } from 'uuid';
|
|
355
|
+
|
|
356
|
+
v6ToV1('1ef22c49-2f62-6d9e-97e9-325096b39f47'); // ⇨ '92f62d9e-22c4-11ef-97e9-325096b39f47'
|
|
357
|
+
```
|
|
358
|
+
|
|
359
|
+
### uuid.v7([options[, buffer[, offset]]])
|
|
360
|
+
|
|
361
|
+
Create an RFC version 7 (random) UUID
|
|
362
|
+
|
|
363
|
+
| | |
|
|
364
|
+
| --- | --- |
|
|
365
|
+
| [`options`] | `Object` with one or more of the following properties: |
|
|
366
|
+
| [`options.msecs = (current time)`] | RFC "timestamp" field (`Number` of milliseconds, unix epoch) |
|
|
367
|
+
| [`options.random = (random)`] | `Array` of 16 random bytes (0-255) used to generate other fields, above |
|
|
368
|
+
| [`options.rng`] | Alternative to `options.random`, a `Function` that returns an `Array` of 16 random bytes (0-255) |
|
|
369
|
+
| [`options.seq = (random)`] | 32-bit sequence `Number` between 0 - 0xffffffff. This may be provided to help ensure uniqueness for UUIDs generated within the same millisecond time interval. Default = random value. |
|
|
370
|
+
| [`buffer`] | `Uint8Array` or `Uint8Array` subtype (e.g. Node.js `Buffer`). If provided, binary UUID is written into the array, starting at `offset` |
|
|
371
|
+
| [`offset` = 0] | `Number` Index to start writing UUID bytes in `buffer` |
|
|
372
|
+
| _returns_ | UUID `String` if no `buffer` is specified, otherwise returns `buffer` |
|
|
373
|
+
|
|
374
|
+
Example:
|
|
375
|
+
|
|
376
|
+
```javascript
|
|
377
|
+
import { v7 as uuidv7 } from 'uuid';
|
|
378
|
+
|
|
379
|
+
uuidv7(); // ⇨ '01695553-c90c-705a-b56d-778dfbbd4bed'
|
|
380
|
+
```
|
|
381
|
+
|
|
382
|
+
### ~~uuid.v8()~~
|
|
383
|
+
|
|
384
|
+
**_"Intentionally left blank"_**
|
|
385
|
+
|
|
386
|
+
<!-- prettier-ignore -->
|
|
387
|
+
> [!NOTE]
|
|
388
|
+
> Version 8 (experimental) UUIDs are "[for experimental or vendor-specific use cases](https://www.rfc-editor.org/rfc/rfc9562.html#name-uuid-version-8)". The RFC does not define a creation algorithm for them, which is why this package does not offer a `v8()` method. The `validate()` and `version()` methods do work with such UUIDs, however.
|
|
389
|
+
|
|
390
|
+
### uuid.validate(str)
|
|
391
|
+
|
|
392
|
+
Test a string to see if it is a valid UUID
|
|
393
|
+
|
|
394
|
+
| | |
|
|
395
|
+
| --------- | --------------------------------------------------- |
|
|
396
|
+
| `str` | `String` to validate |
|
|
397
|
+
| _returns_ | `true` if string is a valid UUID, `false` otherwise |
|
|
398
|
+
|
|
399
|
+
Example:
|
|
400
|
+
|
|
401
|
+
```javascript
|
|
402
|
+
import { validate as uuidValidate } from 'uuid';
|
|
403
|
+
|
|
404
|
+
uuidValidate('not a UUID'); // ⇨ false
|
|
405
|
+
uuidValidate('6ec0bd7f-11c0-43da-975e-2a8ad9ebae0b'); // ⇨ true
|
|
406
|
+
```
|
|
407
|
+
|
|
408
|
+
Using `validate` and `version` together it is possible to do per-version validation, e.g. validate for only v4 UUIds.
|
|
409
|
+
|
|
410
|
+
```javascript
|
|
411
|
+
import { version as uuidVersion } from 'uuid';
|
|
412
|
+
import { validate as uuidValidate } from 'uuid';
|
|
413
|
+
|
|
414
|
+
function uuidValidateV4(uuid) {
|
|
415
|
+
return uuidValidate(uuid) && uuidVersion(uuid) === 4;
|
|
416
|
+
}
|
|
417
|
+
|
|
418
|
+
const v1Uuid = 'd9428888-122b-11e1-b85c-61cd3cbb3210';
|
|
419
|
+
const v4Uuid = '109156be-c4fb-41ea-b1b4-efe1671c5836';
|
|
420
|
+
|
|
421
|
+
uuidValidateV4(v4Uuid); // ⇨ true
|
|
422
|
+
uuidValidateV4(v1Uuid); // ⇨ false
|
|
423
|
+
```
|
|
424
|
+
|
|
425
|
+
### uuid.version(str)
|
|
426
|
+
|
|
427
|
+
Detect RFC version of a UUID
|
|
428
|
+
|
|
429
|
+
| | |
|
|
430
|
+
| --------- | ---------------------------------------- |
|
|
431
|
+
| `str` | A valid UUID `String` |
|
|
432
|
+
| _returns_ | `Number` The RFC version of the UUID |
|
|
433
|
+
| _throws_ | `TypeError` if `str` is not a valid UUID |
|
|
434
|
+
|
|
435
|
+
Example:
|
|
436
|
+
|
|
437
|
+
```javascript
|
|
438
|
+
import { version as uuidVersion } from 'uuid';
|
|
439
|
+
|
|
440
|
+
uuidVersion('45637ec4-c85f-11ea-87d0-0242ac130003'); // ⇨ 1
|
|
441
|
+
uuidVersion('6ec0bd7f-11c0-43da-975e-2a8ad9ebae0b'); // ⇨ 4
|
|
442
|
+
```
|
|
443
|
+
|
|
444
|
+
<!-- prettier-ignore -->
|
|
445
|
+
> [!NOTE]
|
|
446
|
+
> This method returns `0` for the `NIL` UUID, and `15` for the `MAX` UUID.
|
|
447
|
+
|
|
448
|
+
## Command Line
|
|
449
|
+
|
|
450
|
+
UUIDs can be generated from the command line using `uuid`.
|
|
451
|
+
|
|
452
|
+
```shell
|
|
453
|
+
$ npx uuid
|
|
454
|
+
ddeb27fb-d9a0-4624-be4d-4615062daed4
|
|
455
|
+
```
|
|
456
|
+
|
|
457
|
+
The default is to generate version 4 UUIDS, however the other versions are supported. Type `uuid --help` for details:
|
|
458
|
+
|
|
459
|
+
```shell
|
|
460
|
+
$ npx uuid --help
|
|
461
|
+
|
|
462
|
+
Usage:
|
|
463
|
+
uuid
|
|
464
|
+
uuid v1
|
|
465
|
+
uuid v3 <name> <namespace uuid>
|
|
466
|
+
uuid v4
|
|
467
|
+
uuid v5 <name> <namespace uuid>
|
|
468
|
+
uuid v7
|
|
469
|
+
uuid --help
|
|
470
|
+
|
|
471
|
+
Note: <namespace uuid> may be "URL" or "DNS" to use the corresponding UUIDs
|
|
472
|
+
defined by RFC9562
|
|
473
|
+
```
|
|
474
|
+
|
|
475
|
+
## `options` Handling for Timestamp UUIDs
|
|
476
|
+
|
|
477
|
+
Prior to `uuid@11`, it was possible for `options` state to interfere with the internal state used to ensure uniqueness of timestamp-based UUIDs (the `v1()`, `v6()`, and `v7()` methods). Starting with `uuid@11`, this issue has been addressed by using the presence of the `options` argument as a flag to select between two possible behaviors:
|
|
478
|
+
|
|
479
|
+
- Without `options`: Internal state is utilized to improve UUID uniqueness.
|
|
480
|
+
- With `options`: Internal state is **NOT** used and, instead, appropriate defaults are applied as needed.
|
|
481
|
+
|
|
482
|
+
## Support
|
|
483
|
+
|
|
484
|
+
**Browsers**: `uuid` [builds are tested](/uuidjs/uuid/blob/main/wdio.conf.js) against the latest version of desktop Chrome, Safari, Firefox, and Edge. Mobile versions of these same browsers are expected to work but aren't currently tested.
|
|
485
|
+
|
|
486
|
+
**Node**: `uuid` [builds are tested](https://github.com/uuidjs/uuid/blob/main/.github/workflows/ci.yml#L26-L27) against node ([LTS releases](https://github.com/nodejs/Release)), plus one prior. E.g. `node@18` is in maintainence mode, and `node@22` is the current LTS release. So `uuid` supports `node@16`-`node@22`.
|
|
487
|
+
|
|
488
|
+
**Typescript**: TS versions released within the past two years are supported. [source](https://github.com/microsoft/TypeScript/issues/49088#issuecomment-2468723715)
|
|
489
|
+
|
|
490
|
+
## Known issues
|
|
491
|
+
|
|
492
|
+
<!-- This header is referenced as an anchor in src/rng-browser.ts -->
|
|
493
|
+
|
|
494
|
+
### "getRandomValues() not supported"
|
|
495
|
+
|
|
496
|
+
This error occurs in environments where the standard [`crypto.getRandomValues()`](https://developer.mozilla.org/en-US/docs/Web/API/Crypto/getRandomValues) API is not supported. This issue can be resolved by adding an appropriate polyfill:
|
|
497
|
+
|
|
498
|
+
#### React Native / Expo
|
|
499
|
+
|
|
500
|
+
1. Install [`react-native-get-random-values`](https://github.com/LinusU/react-native-get-random-values#readme)
|
|
501
|
+
1. Import it _before_ `uuid`. Since `uuid` might also appear as a transitive dependency of some other imports it's safest to just import `react-native-get-random-values` as the very first thing in your entry point:
|
|
502
|
+
|
|
503
|
+
```javascript
|
|
504
|
+
import 'react-native-get-random-values';
|
|
505
|
+
import { v4 as uuidv4 } from 'uuid';
|
|
506
|
+
```
|
|
507
|
+
|
|
508
|
+
---
|
|
509
|
+
|
|
510
|
+
Markdown generated from [README_js.md](README_js.md) by <a href="https://github.com/broofa/runmd"><image height="13" src="https://camo.githubusercontent.com/5c7c603cd1e6a43370b0a5063d457e0dabb74cf317adc7baba183acb686ee8d0/687474703a2f2f692e696d6775722e636f6d2f634a4b6f3662552e706e67" /></a>
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
export type * from './types.js';
|
|
2
|
+
export { default as MAX } from './max.js';
|
|
3
|
+
export { default as NIL } from './nil.js';
|
|
4
|
+
export { default as parse } from './parse.js';
|
|
5
|
+
export { default as stringify } from './stringify.js';
|
|
6
|
+
export { default as v1 } from './v1.js';
|
|
7
|
+
export { default as v1ToV6 } from './v1ToV6.js';
|
|
8
|
+
export { default as v3 } from './v3.js';
|
|
9
|
+
export { default as v4 } from './v4.js';
|
|
10
|
+
export { default as v5 } from './v5.js';
|
|
11
|
+
export { default as v6 } from './v6.js';
|
|
12
|
+
export { default as v6ToV1 } from './v6ToV1.js';
|
|
13
|
+
export { default as v7 } from './v7.js';
|
|
14
|
+
export { default as validate } from './validate.js';
|
|
15
|
+
export { default as version } from './version.js';
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.version = exports.validate = exports.v7 = exports.v6ToV1 = exports.v6 = exports.v5 = exports.v4 = exports.v3 = exports.v1ToV6 = exports.v1 = exports.stringify = exports.parse = exports.NIL = exports.MAX = void 0;
|
|
4
|
+
var max_js_1 = require("./max.js");
|
|
5
|
+
Object.defineProperty(exports, "MAX", { enumerable: true, get: function () { return max_js_1.default; } });
|
|
6
|
+
var nil_js_1 = require("./nil.js");
|
|
7
|
+
Object.defineProperty(exports, "NIL", { enumerable: true, get: function () { return nil_js_1.default; } });
|
|
8
|
+
var parse_js_1 = require("./parse.js");
|
|
9
|
+
Object.defineProperty(exports, "parse", { enumerable: true, get: function () { return parse_js_1.default; } });
|
|
10
|
+
var stringify_js_1 = require("./stringify.js");
|
|
11
|
+
Object.defineProperty(exports, "stringify", { enumerable: true, get: function () { return stringify_js_1.default; } });
|
|
12
|
+
var v1_js_1 = require("./v1.js");
|
|
13
|
+
Object.defineProperty(exports, "v1", { enumerable: true, get: function () { return v1_js_1.default; } });
|
|
14
|
+
var v1ToV6_js_1 = require("./v1ToV6.js");
|
|
15
|
+
Object.defineProperty(exports, "v1ToV6", { enumerable: true, get: function () { return v1ToV6_js_1.default; } });
|
|
16
|
+
var v3_js_1 = require("./v3.js");
|
|
17
|
+
Object.defineProperty(exports, "v3", { enumerable: true, get: function () { return v3_js_1.default; } });
|
|
18
|
+
var v4_js_1 = require("./v4.js");
|
|
19
|
+
Object.defineProperty(exports, "v4", { enumerable: true, get: function () { return v4_js_1.default; } });
|
|
20
|
+
var v5_js_1 = require("./v5.js");
|
|
21
|
+
Object.defineProperty(exports, "v5", { enumerable: true, get: function () { return v5_js_1.default; } });
|
|
22
|
+
var v6_js_1 = require("./v6.js");
|
|
23
|
+
Object.defineProperty(exports, "v6", { enumerable: true, get: function () { return v6_js_1.default; } });
|
|
24
|
+
var v6ToV1_js_1 = require("./v6ToV1.js");
|
|
25
|
+
Object.defineProperty(exports, "v6ToV1", { enumerable: true, get: function () { return v6ToV1_js_1.default; } });
|
|
26
|
+
var v7_js_1 = require("./v7.js");
|
|
27
|
+
Object.defineProperty(exports, "v7", { enumerable: true, get: function () { return v7_js_1.default; } });
|
|
28
|
+
var validate_js_1 = require("./validate.js");
|
|
29
|
+
Object.defineProperty(exports, "validate", { enumerable: true, get: function () { return validate_js_1.default; } });
|
|
30
|
+
var version_js_1 = require("./version.js");
|
|
31
|
+
Object.defineProperty(exports, "version", { enumerable: true, get: function () { return version_js_1.default; } });
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const crypto_1 = require("crypto");
|
|
4
|
+
function md5(bytes) {
|
|
5
|
+
if (Array.isArray(bytes)) {
|
|
6
|
+
bytes = Buffer.from(bytes);
|
|
7
|
+
}
|
|
8
|
+
else if (typeof bytes === 'string') {
|
|
9
|
+
bytes = Buffer.from(bytes, 'utf8');
|
|
10
|
+
}
|
|
11
|
+
return (0, crypto_1.createHash)('md5').update(bytes).digest();
|
|
12
|
+
}
|
|
13
|
+
exports.default = md5;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"type":"commonjs"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const validate_js_1 = require("./validate.js");
|
|
4
|
+
function parse(uuid) {
|
|
5
|
+
if (!(0, validate_js_1.default)(uuid)) {
|
|
6
|
+
throw TypeError('Invalid UUID');
|
|
7
|
+
}
|
|
8
|
+
let v;
|
|
9
|
+
return Uint8Array.of((v = parseInt(uuid.slice(0, 8), 16)) >>> 24, (v >>> 16) & 0xff, (v >>> 8) & 0xff, v & 0xff, (v = parseInt(uuid.slice(9, 13), 16)) >>> 8, v & 0xff, (v = parseInt(uuid.slice(14, 18), 16)) >>> 8, v & 0xff, (v = parseInt(uuid.slice(19, 23), 16)) >>> 8, v & 0xff, ((v = parseInt(uuid.slice(24, 36), 16)) / 0x10000000000) & 0xff, (v / 0x100000000) & 0xff, (v >>> 24) & 0xff, (v >>> 16) & 0xff, (v >>> 8) & 0xff, v & 0xff);
|
|
10
|
+
}
|
|
11
|
+
exports.default = parse;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export default function rng(): Uint8Array;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const crypto_1 = require("crypto");
|
|
4
|
+
const rnds8Pool = new Uint8Array(256);
|
|
5
|
+
let poolPtr = rnds8Pool.length;
|
|
6
|
+
function rng() {
|
|
7
|
+
if (poolPtr > rnds8Pool.length - 16) {
|
|
8
|
+
(0, crypto_1.randomFillSync)(rnds8Pool);
|
|
9
|
+
poolPtr = 0;
|
|
10
|
+
}
|
|
11
|
+
return rnds8Pool.slice(poolPtr, (poolPtr += 16));
|
|
12
|
+
}
|
|
13
|
+
exports.default = rng;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const crypto_1 = require("crypto");
|
|
4
|
+
function sha1(bytes) {
|
|
5
|
+
if (Array.isArray(bytes)) {
|
|
6
|
+
bytes = Buffer.from(bytes);
|
|
7
|
+
}
|
|
8
|
+
else if (typeof bytes === 'string') {
|
|
9
|
+
bytes = Buffer.from(bytes, 'utf8');
|
|
10
|
+
}
|
|
11
|
+
return (0, crypto_1.createHash)('sha1').update(bytes).digest();
|
|
12
|
+
}
|
|
13
|
+
exports.default = sha1;
|