@posthog/browser-common 0.2.0 → 0.2.1

package/README.md

@@ -96,10 +96,12 @@ if (flags && (await flags.getFeatureFlag('beta-ui'))) {
 }
 ```
 
-A token is implementation-free, so importing it never pulls the provider's code
-into your bundle — each extension stays independently tree-shakable and lazily
-loadable. An extension that provides a capability declares its token(s) in
-`provides`.
+A token is an implementation-free branded string, so importing it never pulls
+the provider's code into your bundle — each extension stays independently
+tree-shakable and lazily loadable. Use a package-qualified runtime string, such
+as `posthog.featureFlags`, that is globally unique and stable so separately
+compiled scripts resolve the same capability. An extension that provides a
+capability declares its token(s) in `provides`.
 
 ## Utilities
 

package/dist/config.js

@@ -26,7 +26,7 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     default: ()=>__WEBPACK_DEFAULT_EXPORT__
 });
-const packageVersion = "0.2.0";
+const packageVersion = "0.2.1";
 const Config = {
     DEBUG: false,
     LIB_VERSION: packageVersion,

package/dist/config.mjs

@@ -1,4 +1,4 @@
-const packageVersion = "0.2.0";
+const packageVersion = "0.2.1";
 const Config = {
     DEBUG: false,
     LIB_VERSION: packageVersion,

package/dist/token.d.ts

@@ -1,21 +1,22 @@
+/** Phantom brand carrying the capability type without emitting runtime code. */
+declare const extensionTokenType: unique symbol;
 /**
- * A typed, implementation-free key for resolving an extension that provides a
- * capability. Declared as a shared `const` next to the providing extension's
+ * A typed, implementation-free string for resolving an extension that provides
+ * a capability. Declared as a shared `const` next to the providing extension's
  * interface:
  *
  * ```ts
  * export interface FeatureFlagsExtension extends Extension { … }
- * export const FeatureFlags: ExtensionToken<FeatureFlagsExtension> = { name: 'featureFlags' }
+ * export const FeatureFlags = 'posthog.featureFlags' as ExtensionToken<FeatureFlagsExtension>
  * ```
  *
  * A token holds no implementation, so importing one never pulls the provider's
- * code into the consumer's bundle. The registry is keyed by token identity
- * (the shared object reference), so provider and consumer must import the same
- * exported token; `name` is for diagnostics only.
+ * code into the consumer's bundle. Its generic brand lets `getExtension` infer
+ * the provided type, while its runtime string value remains stable across
+ * independently compiled scripts. Token strings must be globally unique and
+ * stable for the lifetime of the capability contract.
  */
-export interface ExtensionToken<T> {
-    /** Human-readable capability name used only for diagnostics. */
-    readonly name: string;
-    /** Phantom: carries the provided type for inference; never present at runtime. */
-    readonly __provides?: T;
-}
+export type ExtensionToken<T> = string & {
+    readonly [extensionTokenType]: T;
+};
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/browser-common",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Internal shared browser utilities and extension primitives for PostHog Browser SDKs",
   "license": "MIT",
   "repository": {
@@ -57,8 +57,8 @@
     }
   },
   "dependencies": {
-    "@posthog/core": "^1.44.0",
-    "@posthog/types": "^1.397.1"
+    "@posthog/types": "^1.398.0",
+    "@posthog/core": "^1.45.1"
   },
   "devDependencies": {
     "@rslib/core": "0.10.6",