@application-kit/feature-flags 0.0.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# @application-kit/feature-flags
+
+## 0.2.0
+
+### Minor Changes
+
+- 2a51c82: Каналы значений «сервер → клиент». `vue-ssr`: опция `channels` у `createSsrEntry` и `hydrateSsrApplication`, контракт `SsrChannelInterface`, `PiniaPlugin`. Ломает: `describePage` заменена на `resolveLang`, значения `window.*` идут только каналами; `channels` обязательна у обеих функций, `beforeMount` стал необязательным. `i18n/vue`: `createLocaleChannel`. `feature-flags/vue`: `createFeatureFlagChannel`.
+
+## 0.1.0
+
+### Minor Changes
+
+- 5b3aacf: Первый выпуск: набор флагов `defineFeatureFlags` с реестром имён `FeatureFlagRegistryInterface` (module augmentation),
+  разбор окружения с отказом на незнакомой и пропущенной переменной, порт `FeatureFlagsInterface`, токен `FEATURE_FLAGS` и
+  адаптер `EnvironmentFeatureFlags` (корень, изоморфно); `useFeatureFlag`, ключ `FEATURE_FLAG_STATE` и разбор SSR-состояния
+  `parseFeatureFlagState` (вход `/vue`); фейк порта `FakeFeatureFlags` (вход `/testing`).

package/README.md

@@ -25,7 +25,7 @@ Peer: `@libs-for-dev/nestjs-config-module` (подпуть `/parse-boolean` —
 | Вход | Что внутри | Зависимости |
 |---|---|---|
 | `@application-kit/feature-flags` | `defineFeatureFlags`, реестр `FeatureFlagRegistryInterface`, порт `FeatureFlagsInterface`, токен `FEATURE_FLAGS`, адаптер `EnvironmentFeatureFlags`, ошибки | изоморфно, без Nest и DOM |
-| `@application-kit/feature-flags/vue` | `useFeatureFlag`, ключ `FEATURE_FLAG_STATE`, `parseFeatureFlagState` | `vue` |
+| `@application-kit/feature-flags/vue` | `useFeatureFlag`, ключ `FEATURE_FLAG_STATE`, `parseFeatureFlagState`, `createFeatureFlagChannel` | `vue` |
 | `@application-kit/feature-flags/testing` | `FakeFeatureFlags` | — |
 
 Корень грузится и в клиентском бандле (набор нужен разбору SSR-состояния), поэтому связки с Nest в пакете нет:
@@ -129,6 +129,20 @@ Vue, где `await` в разметке невозможен. Адаптер с
 
 Публичный срез уезжает на страницу SSR-состоянием:
 
+С `@application-kit/vue-ssr` состояние едет каналом — ставится до рендера и уезжает на страницу одним значением:
+
+```ts
+const featureFlagChannel = createFeatureFlagChannel(featureFlags)
+
+// сервер, опция createSsrEntry
+channels: () => [featureFlagChannel.withValue(featureFlagsPort.publicState())],
+
+// клиент, опция hydrateSsrApplication
+channels: [featureFlagChannel],
+```
+
+Без него — те же шаги руками:
+
 ```ts
 // сервер, перед renderToString
 const state = featureFlagsPort.publicState()

package/dist/cjs/vue/feature-flag-channel.d.ts

@@ -0,0 +1,14 @@
+import type { App } from 'vue';
+import type { FeatureFlagSetInterface } from '../define-feature-flags.js';
+import type { FeatureFlagState } from '../feature-flag-registry.js';
+export interface FeatureFlagChannelInterface {
+    readonly key: string;
+    restore(app: App, serialized: string | undefined): void;
+    withValue(state: FeatureFlagState): FeatureFlagChannelValueInterface;
+}
+export interface FeatureFlagChannelValueInterface {
+    apply(app: App): void;
+    readonly key: string;
+    readonly serialized: string;
+}
+export declare const createFeatureFlagChannel: (featureFlags: FeatureFlagSetInterface) => FeatureFlagChannelInterface;

package/dist/cjs/vue/feature-flag-channel.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFeatureFlagChannel = void 0;
+const parse_feature_flag_state_js_1 = require("./parse-feature-flag-state.js");
+const use_feature_flag_js_1 = require("./use-feature-flag.js");
+const FEATURE_FLAG_CHANNEL_KEY = 'ssrFeatureFlags';
+const createFeatureFlagChannel = (featureFlags) => ({
+    key: FEATURE_FLAG_CHANNEL_KEY,
+    restore: (app, serialized) => {
+        app.provide(use_feature_flag_js_1.FEATURE_FLAG_STATE, (0, parse_feature_flag_state_js_1.parseFeatureFlagState)(featureFlags, serialized));
+    },
+    withValue: (state) => ({
+        apply: (app) => {
+            app.provide(use_feature_flag_js_1.FEATURE_FLAG_STATE, state);
+        },
+        key: FEATURE_FLAG_CHANNEL_KEY,
+        serialized: JSON.stringify(state),
+    }),
+});
+exports.createFeatureFlagChannel = createFeatureFlagChannel;

package/dist/cjs/vue/index.d.ts

@@ -1,2 +1,3 @@
+export * from './feature-flag-channel.js';
 export * from './parse-feature-flag-state.js';
 export * from './use-feature-flag.js';

package/dist/cjs/vue/index.js

@@ -14,5 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./feature-flag-channel.js"), exports);
 __exportStar(require("./parse-feature-flag-state.js"), exports);
 __exportStar(require("./use-feature-flag.js"), exports);

package/dist/esm/vue/feature-flag-channel.d.ts

@@ -0,0 +1,14 @@
+import type { App } from 'vue';
+import type { FeatureFlagSetInterface } from '../define-feature-flags.js';
+import type { FeatureFlagState } from '../feature-flag-registry.js';
+export interface FeatureFlagChannelInterface {
+    readonly key: string;
+    restore(app: App, serialized: string | undefined): void;
+    withValue(state: FeatureFlagState): FeatureFlagChannelValueInterface;
+}
+export interface FeatureFlagChannelValueInterface {
+    apply(app: App): void;
+    readonly key: string;
+    readonly serialized: string;
+}
+export declare const createFeatureFlagChannel: (featureFlags: FeatureFlagSetInterface) => FeatureFlagChannelInterface;

package/dist/esm/vue/feature-flag-channel.js

@@ -0,0 +1,16 @@
+import { parseFeatureFlagState } from './parse-feature-flag-state.js';
+import { FEATURE_FLAG_STATE } from './use-feature-flag.js';
+const FEATURE_FLAG_CHANNEL_KEY = 'ssrFeatureFlags';
+export const createFeatureFlagChannel = (featureFlags) => ({
+    key: FEATURE_FLAG_CHANNEL_KEY,
+    restore: (app, serialized) => {
+        app.provide(FEATURE_FLAG_STATE, parseFeatureFlagState(featureFlags, serialized));
+    },
+    withValue: (state) => ({
+        apply: (app) => {
+            app.provide(FEATURE_FLAG_STATE, state);
+        },
+        key: FEATURE_FLAG_CHANNEL_KEY,
+        serialized: JSON.stringify(state),
+    }),
+});

package/dist/esm/vue/index.d.ts

@@ -1,2 +1,3 @@
+export * from './feature-flag-channel.js';
 export * from './parse-feature-flag-state.js';
 export * from './use-feature-flag.js';

package/dist/esm/vue/index.js

@@ -1,2 +1,3 @@
+export * from './feature-flag-channel.js';
 export * from './parse-feature-flag-state.js';
 export * from './use-feature-flag.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@application-kit/feature-flags",
-  "version": "0.0.0",
+  "version": "0.2.0",
   "description": "Фичефлаги из окружения: набор флагов параметром, порт с адаптером окружения, SSR-состояние для Vue и фейк для спек",
   "keywords": [
     "feature-flags",