@justscale/core 0.1.0

package/dist/features/environment/types.d.ts

@@ -0,0 +1,165 @@
+import type { Component } from '../../builder/index.js';
+import type { VaultKind } from '../vault/types.js';
+import type { ConfigPartial, ConfigComponent } from '../config/types.js';
+import type { SecretPartial, SecretComponent } from '../secrets/types.js';
+import type { FeatureFlagPartial, FeatureFlagComponent } from '../feature-flags/types.js';
+/** All valid environment types. */
+export declare const ENVIRONMENT_TYPES: readonly ["production", "test", "development", "ci"];
+export type EnvironmentType = typeof ENVIRONMENT_TYPES[number];
+/**
+ * Vault-policy rules applied at build time.
+ * `disallow` throws on matching VAULT_KIND brands; `warn` logs and permits.
+ */
+export interface VaultPolicyRules {
+    disallow?: VaultKind[];
+    warn?: VaultKind[];
+}
+/** Vault-policy option on `createEnvironment`. `extend` merges additional rules. */
+export interface VaultPolicy {
+    extend?: VaultPolicyRules;
+}
+export declare const DEFAULT_VAULT_POLICY: Record<EnvironmentType, VaultPolicyRules>;
+/**
+ * Marker brand for Environment values. Cross-realm: env files loaded from
+ * /tmp paths may resolve @justscale/core to a different module instance,
+ * so the marker must be globally interned for the identity check to match.
+ */
+export declare const ENVIRONMENT: unique symbol;
+export interface Environment<S extends readonly Component[] = readonly Component[], P extends readonly Component[] = readonly Component[]> {
+    readonly [ENVIRONMENT]: true;
+    readonly name: string;
+    readonly type: EnvironmentType;
+    readonly public: Record<string, unknown>;
+    readonly services: S;
+    readonly providers: P;
+    readonly vaultPolicy: VaultPolicyRules;
+}
+export declare function isEnvironment(value: unknown): value is Environment;
+/**
+ * Declarative contract describing the partials a specific app's env
+ * supplies. Used with `loadEnvironment<T>()`, `createEnvironment<T>()`,
+ * and `defineApp<T>()` so the builder's feature-requirement type checks
+ * don't lose information when the env is loaded dynamically.
+ *
+ * @example
+ * ```ts
+ * // src/env-contract.ts
+ * export type AppEnv = EnvContract<{
+ *   config:  [typeof AppConfig, typeof HttpConfig, typeof PostgresProcessConfig],
+ *   secrets: [typeof PostgresSecrets],
+ *   flags:   [typeof UserFlags],
+ * }>;
+ *
+ * // src/app.ts
+ * export default defineApp<AppEnv>(import.meta, (env) =>
+ *   JustScale().add(env).add(PostgresFeature) // TS: env provides PostgresSecrets ✓
+ * );
+ *
+ * // env/development.ts
+ * export default createEnvironment<AppEnv>({ ... });
+ * // ^ providers[] must cover every partial in AppEnv or TS errors.
+ * ```
+ */
+export type EnvContract<T extends {
+    readonly config?: readonly ConfigPartial<any>[];
+    readonly secrets?: readonly SecretPartial<any>[];
+    readonly flags?: readonly FeatureFlagPartial<any>[];
+    readonly services?: readonly Component[];
+}> = Environment<T['services'] extends readonly Component[] ? T['services'] : readonly [], readonly [
+    ...(T['config'] extends readonly ConfigPartial<any>[] ? [ConfigComponent<T['config']>] : []),
+    ...(T['secrets'] extends readonly SecretPartial<any>[] ? [SecretComponent<T['secrets']>] : []),
+    ...(T['flags'] extends readonly FeatureFlagPartial<any>[] ? [FeatureFlagComponent<T['flags']>] : [])
+]>;
+/**
+ * Registry of config partials that the app's imports make visible.
+ * Each feature augments this interface via `declare module '@justscale/core'`;
+ * the app then derives its `Env` type directly from the merged shape
+ * instead of re-listing every partial by hand.
+ *
+ * @example Feature-side augmentation
+ * ```ts
+ * // @justscale/http
+ * declare module '@justscale/core' {
+ *   interface RegisteredConfigPartials {
+ *     http: typeof HttpConfig;
+ *   }
+ * }
+ * ```
+ *
+ * @example App-side usage
+ * ```ts
+ * // simple-app/src/env-contract.ts
+ * export type AppEnv = Env;   // all registered partials, no manual list
+ * ```
+ *
+ * Augmentations are scoped per-compilation: only features actually
+ * imported from the app's compile graph contribute.
+ */
+export interface RegisteredConfigPartials {
+}
+export interface RegisteredSecretPartials {
+}
+export interface RegisteredFlagPartials {
+}
+type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+type LastOf<T> = UnionToIntersection<T extends unknown ? () => T : never> extends () => infer R ? R : never;
+type UnionToTuple<T, Last = LastOf<T>> = [
+    T
+] extends [never] ? [] : [...UnionToTuple<Exclude<T, Last>>, Last];
+type TupleFromInterfaceValues<T> = [
+    T[keyof T]
+] extends [never] ? readonly [] : Readonly<UnionToTuple<T[keyof T]>>;
+type RegisteredConfigTuple = TupleFromInterfaceValues<RegisteredConfigPartials> extends readonly ConfigPartial<any>[] ? TupleFromInterfaceValues<RegisteredConfigPartials> : readonly [];
+type RegisteredSecretTuple = TupleFromInterfaceValues<RegisteredSecretPartials> extends readonly SecretPartial<any>[] ? TupleFromInterfaceValues<RegisteredSecretPartials> : readonly [];
+type RegisteredFlagTuple = TupleFromInterfaceValues<RegisteredFlagPartials> extends readonly FeatureFlagPartial<any>[] ? TupleFromInterfaceValues<RegisteredFlagPartials> : readonly [];
+/**
+ * Env contract combining feature-registered partials with app-specific extras.
+ *
+ * @example
+ * ```ts
+ * export type AppEnv = Env<{
+ *   config: [typeof AppConfig],
+ *   flags:  [typeof UserFlags],
+ * }>;
+ * ```
+ */
+export type Env<Extras extends {
+    readonly config?: readonly ConfigPartial<any>[];
+    readonly secrets?: readonly SecretPartial<any>[];
+    readonly flags?: readonly FeatureFlagPartial<any>[];
+    readonly services?: readonly Component[];
+} = {}> = EnvContract<{
+    services: Extras['services'] extends readonly Component[] ? Extras['services'] : readonly [];
+    config: readonly [
+        ...RegisteredConfigTuple,
+        ...(Extras['config'] extends readonly ConfigPartial<any>[] ? Extras['config'] : readonly [])
+    ];
+    secrets: readonly [
+        ...RegisteredSecretTuple,
+        ...(Extras['secrets'] extends readonly SecretPartial<any>[] ? Extras['secrets'] : readonly [])
+    ];
+    flags: readonly [
+        ...RegisteredFlagTuple,
+        ...(Extras['flags'] extends readonly FeatureFlagPartial<any>[] ? Extras['flags'] : readonly [])
+    ];
+}>;
+/**
+ * Type-level vault compatibility brand. A concrete vault service can be
+ * tagged with the set of EnvironmentTypes it is permitted in. When passed
+ * into `createEnvironment`, the env's `type` is checked against this brand
+ * and incompatible combinations become a TS type error.
+ *
+ * Services without the brand are treated as env-neutral (allowed anywhere).
+ */
+declare const VAULT_ALLOWED_IN: unique symbol;
+export interface VaultAllowedIn<T extends EnvironmentType> {
+    readonly [VAULT_ALLOWED_IN]?: T;
+}
+/**
+ * Given a service token type S and an environment type T, resolve to S if
+ * S is either un-branded (any env) or allows T - otherwise resolve to
+ * `never` so a TS assignment error fires at the incompatible position.
+ */
+export type ServiceCompatibleWithEnv<S, T extends EnvironmentType> = S extends VaultAllowedIn<infer Allowed> ? T extends Allowed ? S : never : S;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/features/environment/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/environment/types.ts"],"names":[],"mappings":"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"}

package/dist/features/environment/types.js

@@ -0,0 +1,18 @@
+/** All valid environment types. */
+export const ENVIRONMENT_TYPES = ['production', 'test', 'development', 'ci'];
+export const DEFAULT_VAULT_POLICY = {
+    production: { disallow: ['hardcoded'] },
+    ci: { disallow: ['hardcoded'] },
+    test: {},
+    development: {},
+};
+/**
+ * Marker brand for Environment values. Cross-realm: env files loaded from
+ * /tmp paths may resolve @justscale/core to a different module instance,
+ * so the marker must be globally interned for the identity check to match.
+ */
+export const ENVIRONMENT = Symbol.for('justscale.environment');
+export function isEnvironment(value) {
+    return typeof value === 'object' && value !== null && ENVIRONMENT in value;
+}
+//# sourceMappingURL=types.js.map

package/dist/features/environment/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/environment/types.ts"],"names":[],"mappings":"AAMA,mCAAmC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,CAAU,CAAC;AAiBtF,MAAM,CAAC,MAAM,oBAAoB,GAA8C;IAC7E,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE;IACvC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE;IAC/B,IAAI,EAAE,EAAE;IACR,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAe/D,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,WAAW,IAAI,KAAK,CAAC;AAC7E,CAAC"}

package/dist/features/feature-flags/create-feature-flag-provider.d.ts

@@ -0,0 +1,21 @@
+import type { ServiceToken, InstanceOf } from '../../core/service.js';
+import type { FeatureFlagPartial, FeatureFlagComponent } from './types.js';
+type InferDeps<T extends Record<string, ServiceToken<any>>> = {
+    [K in keyof T]: InstanceOf<T[K]>;
+};
+type FlagFactory<TInject extends Record<string, ServiceToken<any>>> = (deps: InferDeps<TInject>) => Record<symbol, any> | Promise<Record<symbol, any>>;
+interface CreateFeatureFlagProviderOptions<TInject extends Record<string, ServiceToken<any>>, P extends readonly FeatureFlagPartial<any>[]> {
+    provides?: P;
+    inject?: TInject;
+    factory: FlagFactory<TInject>;
+}
+/**
+ * Create a FeatureFlagProvider - loads initial flag values at boot.
+ *
+ * For reactive updates (external flag system changed a value), an injected
+ * adapter subscribes to the source and calls FeatureFlagService.update()
+ * to push new values into the container.
+ */
+export declare function createFeatureFlagProvider<const TInject extends Record<string, ServiceToken<any>> = {}, const P extends readonly FeatureFlagPartial<any>[] = readonly []>(options: CreateFeatureFlagProviderOptions<TInject, P>): FeatureFlagComponent<P>;
+export {};
+//# sourceMappingURL=create-feature-flag-provider.d.ts.map

package/dist/features/feature-flags/create-feature-flag-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-feature-flag-provider.d.ts","sourceRoot":"","sources":["../../../src/features/feature-flags/create-feature-flag-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3E,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI;KAC3D,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACjC,CAAC;AAEF,KAAK,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,IAChE,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAEnF,UAAU,gCAAgC,CACxC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EACjD,CAAC,SAAS,SAAS,kBAAkB,CAAC,GAAG,CAAC,EAAE;IAE5C,QAAQ,CAAC,EAAE,CAAC,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAC5D,KAAK,CAAC,CAAC,SAAS,SAAS,kBAAkB,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,EAAE,EAChE,OAAO,EAAE,gCAAgC,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAOhF"}

package/dist/features/feature-flags/create-feature-flag-provider.js

@@ -0,0 +1,16 @@
+/**
+ * Create a FeatureFlagProvider - loads initial flag values at boot.
+ *
+ * For reactive updates (external flag system changed a value), an injected
+ * adapter subscribes to the source and calls FeatureFlagService.update()
+ * to push new values into the container.
+ */
+export function createFeatureFlagProvider(options) {
+    return {
+        __featureFlagComponent: true,
+        provides: (options.provides ?? []),
+        inject: (options.inject ?? {}),
+        factory: options.factory,
+    };
+}
+//# sourceMappingURL=create-feature-flag-provider.js.map

package/dist/features/feature-flags/create-feature-flag-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-feature-flag-provider.js","sourceRoot":"","sources":["../../../src/features/feature-flags/create-feature-flag-provider.ts"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAGvC,OAAqD;IACrD,OAAO;QACL,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAM;QACvC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAA+B;QAC5D,OAAO,EAAE,OAAO,CAAC,OAAyD;KAC3E,CAAC;AACJ,CAAC"}

package/dist/features/feature-flags/define-feature-flag-partial.d.ts

@@ -0,0 +1,20 @@
+import type { z } from 'zod';
+import { type FeatureFlagPartial } from './types.js';
+/**
+ * Define a feature-flag partial with a Zod schema.
+ *
+ * The returned object carries a fresh `Symbol('featureFlag:<name>')` on
+ * `.key`. Plain `Symbol()` (not `Symbol.for`) so two features that happen
+ * to pick the same name get distinct tokens and do not silently share a
+ * container slot. Consumers import the token object from the declaring
+ * module and inject it via `FeatureFlag.of(partial)`; no string-keyed
+ * lookup is involved.
+ *
+ * @example
+ * const CheckoutFlags = defineFeatureFlagPartial('checkout', z.object({
+ *   newPayment: z.boolean(),
+ *   cohort: z.enum(['a', 'b']),
+ * }))
+ */
+export declare function defineFeatureFlagPartial<T extends z.ZodType>(name: string, schema: T): FeatureFlagPartial<z.infer<T>>;
+//# sourceMappingURL=define-feature-flag-partial.d.ts.map

package/dist/features/feature-flags/define-feature-flag-partial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-feature-flag-partial.d.ts","sourceRoot":"","sources":["../../../src/features/feature-flags/define-feature-flag-partial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE3E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC1D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,GACR,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAOhC"}

package/dist/features/feature-flags/define-feature-flag-partial.js

@@ -0,0 +1,26 @@
+import { FEATURE_FLAG_PARTIAL } from './types.js';
+/**
+ * Define a feature-flag partial with a Zod schema.
+ *
+ * The returned object carries a fresh `Symbol('featureFlag:<name>')` on
+ * `.key`. Plain `Symbol()` (not `Symbol.for`) so two features that happen
+ * to pick the same name get distinct tokens and do not silently share a
+ * container slot. Consumers import the token object from the declaring
+ * module and inject it via `FeatureFlag.of(partial)`; no string-keyed
+ * lookup is involved.
+ *
+ * @example
+ * const CheckoutFlags = defineFeatureFlagPartial('checkout', z.object({
+ *   newPayment: z.boolean(),
+ *   cohort: z.enum(['a', 'b']),
+ * }))
+ */
+export function defineFeatureFlagPartial(name, schema) {
+    return {
+        [FEATURE_FLAG_PARTIAL]: true,
+        key: Symbol(`featureFlag:${name}`),
+        name,
+        schema: schema,
+    };
+}
+//# sourceMappingURL=define-feature-flag-partial.js.map

package/dist/features/feature-flags/define-feature-flag-partial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-feature-flag-partial.js","sourceRoot":"","sources":["../../../src/features/feature-flags/define-feature-flag-partial.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAA2B,MAAM,YAAY,CAAC;AAE3E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,MAAS;IAET,OAAO;QACL,CAAC,oBAAoB,CAAC,EAAE,IAAI;QAC5B,GAAG,EAAE,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC;QAClC,IAAI;QACJ,MAAM,EAAE,MAA+B;KACxC,CAAC;AACJ,CAAC"}

package/dist/features/feature-flags/feature-flag-of.d.ts

@@ -0,0 +1,16 @@
+import type { Token } from '../../builder/index.js';
+import type { FeatureFlagPartial } from './types.js';
+declare const FEATURE_FLAG_TOKEN_BRAND: unique symbol;
+export interface FeatureFlagToken<T> extends Token<T> {
+    readonly [FEATURE_FLAG_TOKEN_BRAND]?: T;
+    readonly description: string;
+    readonly key: symbol;
+    resolve(container: {
+        get(key: symbol): T;
+    }): T;
+}
+export declare const FeatureFlag: {
+    of<T>(partial: FeatureFlagPartial<T>): FeatureFlagToken<T>;
+};
+export {};
+//# sourceMappingURL=feature-flag-of.d.ts.map

package/dist/features/feature-flags/feature-flag-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag-of.d.ts","sourceRoot":"","sources":["../../../src/features/feature-flags/feature-flag-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,CAAC,MAAM,wBAAwB,EAAE,OAAO,MAAM,CAAC;AAEtD,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,SAAS,EAAE;QAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAA;KAAE,GAAG,CAAC,CAAA;CAC/C;AAID,eAAO,MAAM,WAAW;OACnB,CAAC,WAAW,kBAAkB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;CAW3D,CAAC"}

package/dist/features/feature-flags/feature-flag-of.js

@@ -0,0 +1,16 @@
+const tokenCache = new WeakMap();
+export const FeatureFlag = {
+    of(partial) {
+        const cached = tokenCache.get(partial);
+        if (cached)
+            return cached;
+        const token = {
+            description: `FeatureFlag.of(${partial.name})`,
+            key: partial.key,
+            resolve: (container) => container.get(partial.key),
+        };
+        tokenCache.set(partial, token);
+        return token;
+    },
+};
+//# sourceMappingURL=feature-flag-of.js.map

package/dist/features/feature-flags/feature-flag-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag-of.js","sourceRoot":"","sources":["../../../src/features/feature-flags/feature-flag-of.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,GAAG,IAAI,OAAO,EAAkD,CAAC;AAEjF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,EAAE,CAAI,OAA8B;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,MAAM;YAAE,OAAO,MAA6B,CAAC;QACjD,MAAM,KAAK,GAAwB;YACjC,WAAW,EAAE,kBAAkB,OAAO,CAAC,IAAI,GAAG;YAC9C,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,CAAC,SAAsC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC;SACzD,CAAC;QACzB,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/features/feature-flags/feature-flag-service.d.ts

@@ -0,0 +1,22 @@
+import type { FeatureFlagPartial } from './types.js';
+/**
+ * Feature flag access with reactive updates.
+ *
+ * - `.read(partial)` - current value.
+ * - `.update(partial, value)` - push a new value (used by external flag
+ *   adapters when the upstream source changes).
+ * - `.watch(partial)` - async-iterable of [old, new] pairs.
+ *
+ * No disk persistence - runtime-only. Providers supply initial values at
+ * boot; adapters call `.update()` to push subsequent changes.
+ */
+export interface FeatureFlagService {
+    read<T>(partial: FeatureFlagPartial<T>): Promise<T>;
+    update<T>(partial: FeatureFlagPartial<T>, value: T): Promise<number>;
+    watch<T>(partial: FeatureFlagPartial<T>): AsyncIterable<[T, T]>;
+}
+declare const FeatureFlagServiceDef_base: import("../../core/service.js").Service<FeatureFlagService, {}>;
+export declare class FeatureFlagServiceDef extends FeatureFlagServiceDef_base {
+}
+export {};
+//# sourceMappingURL=feature-flag-service.d.ts.map

package/dist/features/feature-flags/feature-flag-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag-service.d.ts","sourceRoot":"","sources":["../../../src/features/feature-flags/feature-flag-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAqBrD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACnD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACpE,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;CAChE;;AA4FD,qBAAa,qBAAsB,SAAQ,0BAGzC;CAAG"}

package/dist/features/feature-flags/feature-flag-service.js

@@ -0,0 +1,112 @@
+import { defineService } from '../../core/index.js';
+/**
+ * Structural equality for flag values (plain JSON-ish shapes from providers).
+ * Cheap enough for the update() hot path; objects are small and shallow.
+ */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null)
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    for (const k of aKeys) {
+        if (!deepEqual(a[k], b[k]))
+            return false;
+    }
+    return true;
+}
+class FeatureFlagServiceImpl {
+    resolver;
+    watchers = new Map();
+    constructor(resolver) {
+        this.resolver = resolver;
+    }
+    async read(partial) {
+        const value = await this.resolver(partial.key);
+        if (value === undefined) {
+            throw new Error(`FeatureFlagService.read: no provider registered a value for feature-flag partial '${partial.name}'.`);
+        }
+        return value;
+    }
+    async update(partial, value) {
+        partial.schema.parse(value);
+        const oldValue = await this.resolver(partial.key).catch(() => undefined);
+        // Skip the notify loop when nothing actually changed. External
+        // adapters (LaunchDarkly, Unleash) poll and call update() on every
+        // tick; without this every watcher wakes for no reason.
+        if (oldValue !== undefined && deepEqual(oldValue, value)) {
+            return 0;
+        }
+        this.resolver.registerInstance(partial.key, value);
+        const callbacks = this.watchers.get(partial.key) ?? new Set();
+        let notified = 0;
+        for (const cb of callbacks) {
+            try {
+                cb(oldValue, value);
+                notified++;
+            }
+            catch (err) {
+                // Don't silently unsubscribe - a buggy callback shouldn't drop
+                // the watcher. Log and continue; callers remove via `return()`.
+                console.error('[FeatureFlagService] watcher threw, continuing:', err);
+            }
+        }
+        return notified;
+    }
+    watch(partial) {
+        const watchers = this.watchers;
+        const key = partial.key;
+        return {
+            [Symbol.asyncIterator]() {
+                const queue = [];
+                let pending = null;
+                let done = false;
+                const cb = (oldVal, newVal) => {
+                    if (done)
+                        return;
+                    const pair = [oldVal, newVal];
+                    if (pending) {
+                        pending({ value: pair, done: false });
+                        pending = null;
+                    }
+                    else {
+                        queue.push(pair);
+                    }
+                };
+                if (!watchers.has(key))
+                    watchers.set(key, new Set());
+                watchers.get(key).add(cb);
+                return {
+                    async next() {
+                        if (queue.length)
+                            return { value: queue.shift(), done: false };
+                        if (done)
+                            return { value: undefined, done: true };
+                        return new Promise((r) => { pending = r; });
+                    },
+                    async return() {
+                        done = true;
+                        watchers.get(key)?.delete(cb);
+                        return { value: undefined, done: true };
+                    },
+                    async throw(e) {
+                        done = true;
+                        watchers.get(key)?.delete(cb);
+                        throw e;
+                    },
+                };
+            },
+        };
+    }
+}
+export class FeatureFlagServiceDef extends defineService({
+    inject: {},
+    factory: (_deps, resolver) => new FeatureFlagServiceImpl(resolver),
+}) {
+}
+//# sourceMappingURL=feature-flag-service.js.map

package/dist/features/feature-flags/feature-flag-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag-service.js","sourceRoot":"","sources":["../../../src/features/feature-flags/feature-flag-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAiB,MAAM,qBAAqB,CAAC;AAKnE;;;GAGG;AACH,SAAS,SAAS,CAAC,CAAU,EAAE,CAAU;IACvC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC7F,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAW,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAW,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,SAAS,CAAE,CAA6B,CAAC,CAAC,CAAC,EAAG,CAA6B,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACrG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAmBD,MAAM,sBAAsB;IAGG;IAFrB,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IAE3D,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAEnD,KAAK,CAAC,IAAI,CAAI,OAA8B;QAC1C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAI,OAAO,CAAC,GAAU,CAAC,CAAC;QACzD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,qFAAqF,OAAO,CAAC,IAAI,IAAI,CACtG,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,MAAM,CAAI,OAA8B,EAAE,KAAQ;QACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAI,OAAO,CAAC,GAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAEnF,+DAA+D;QAC/D,mEAAmE;QACnE,wDAAwD;QACxD,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,gBAAiB,CAAC,OAAO,CAAC,GAAU,EAAE,KAAK,CAAC,CAAC;QAE3D,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAC9D,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACpB,QAAQ,EAAE,CAAC;YACb,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,+DAA+D;gBAC/D,gEAAgE;gBAEhE,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,GAAG,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAI,OAA8B;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QAExB,OAAO;YACL,CAAC,MAAM,CAAC,aAAa,CAAC;gBACpB,MAAM,KAAK,GAAkB,EAAE,CAAC;gBAChC,IAAI,OAAO,GAAiD,IAAI,CAAC;gBACjE,IAAI,IAAI,GAAG,KAAK,CAAC;gBAEjB,MAAM,EAAE,GAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;oBAC7C,IAAI,IAAI;wBAAE,OAAO;oBACjB,MAAM,IAAI,GAAW,CAAC,MAAW,EAAE,MAAW,CAAC,CAAC;oBAChD,IAAI,OAAO,EAAE,CAAC;wBACZ,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;wBACtC,OAAO,GAAG,IAAI,CAAC;oBACjB,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACnB,CAAC;gBACH,CAAC,CAAC;gBAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;gBACrD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAE3B,OAAO;oBACL,KAAK,CAAC,IAAI;wBACR,IAAI,KAAK,CAAC,MAAM;4BAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;wBAChE,IAAI,IAAI;4BAAE,OAAO,EAAE,KAAK,EAAE,SAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;wBACzD,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC9C,CAAC;oBACD,KAAK,CAAC,MAAM;wBACV,IAAI,GAAG,IAAI,CAAC;wBACZ,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;wBAC9B,OAAO,EAAE,KAAK,EAAE,SAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;oBACjD,CAAC;oBACD,KAAK,CAAC,KAAK,CAAC,CAAQ;wBAClB,IAAI,GAAG,IAAI,CAAC;wBACZ,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;wBAC9B,MAAM,CAAC,CAAC;oBACV,CAAC;iBACF,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,aAAa,CAAC;IACvD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAsB,EAAE,CAAC,IAAI,sBAAsB,CAAC,QAAQ,CAAC;CACvF,CAAC;CAAG"}

package/dist/features/feature-flags/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @justscale/core/feature-flags
+ *
+ * Reactive feature-flag management. Values live in memory, update via
+ * external adapters, observable via `.watch()`.
+ */
+export { FEATURE_FLAG_PARTIAL, isFeatureFlagPartial, isFeatureFlagComponent, } from './types.js';
+export type { FeatureFlagPartial, FeatureFlagComponent, } from './types.js';
+export { defineFeatureFlagPartial } from './define-feature-flag-partial.js';
+export { FeatureFlag } from './feature-flag-of.js';
+export type { FeatureFlagToken } from './feature-flag-of.js';
+export { createFeatureFlagProvider } from './create-feature-flag-provider.js';
+export { FeatureFlagServiceDef } from './feature-flag-service.js';
+export type { FeatureFlagService } from './feature-flag-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/feature-flags/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/feature-flags/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/features/feature-flags/index.js

@@ -0,0 +1,12 @@
+/**
+ * @justscale/core/feature-flags
+ *
+ * Reactive feature-flag management. Values live in memory, update via
+ * external adapters, observable via `.watch()`.
+ */
+export { FEATURE_FLAG_PARTIAL, isFeatureFlagPartial, isFeatureFlagComponent, } from './types.js';
+export { defineFeatureFlagPartial } from './define-feature-flag-partial.js';
+export { FeatureFlag } from './feature-flag-of.js';
+export { createFeatureFlagProvider } from './create-feature-flag-provider.js';
+export { FeatureFlagServiceDef } from './feature-flag-service.js';
+//# sourceMappingURL=index.js.map

package/dist/features/feature-flags/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/feature-flags/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/features/feature-flags/types.d.ts

@@ -0,0 +1,30 @@
+import type { z } from 'zod';
+import type { Token } from '../../builder/index.js';
+export declare const FEATURE_FLAG_PARTIAL: unique symbol;
+/**
+ * A feature-flag partial - shape and validation for a flag slice.
+ *
+ * Parallel to ConfigPartial/SecretPartial. Flag values live in memory and
+ * may change at runtime: external adapters (LaunchDarkly, Unleash) call
+ * FeatureFlagService.update() when they observe a change, which notifies
+ * watchers.
+ */
+export interface FeatureFlagPartial<T> {
+    readonly [FEATURE_FLAG_PARTIAL]: true;
+    readonly key: symbol;
+    readonly name: string;
+    readonly schema: z.ZodType<T>;
+}
+export declare function isFeatureFlagPartial(value: unknown): value is FeatureFlagPartial<unknown>;
+/**
+ * Component returned by createFeatureFlagProvider().
+ * Builder runs its factory at boot for initial values.
+ */
+export interface FeatureFlagComponent<P extends readonly FeatureFlagPartial<any>[] = readonly FeatureFlagPartial<any>[]> {
+    readonly __featureFlagComponent: true;
+    readonly provides: P;
+    readonly inject: Record<string, Token<any>>;
+    readonly factory: (deps: Record<string, any>) => Record<symbol, any> | Promise<Record<symbol, any>>;
+}
+export declare function isFeatureFlagComponent(value: unknown): value is FeatureFlagComponent;
+//# sourceMappingURL=types.d.ts.map

package/dist/features/feature-flags/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/feature-flags/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD,eAAO,MAAM,oBAAoB,eAAgC,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAA;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;CAC9B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAEzF;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,SAAS,kBAAkB,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,kBAAkB,CAAC,GAAG,CAAC,EAAE;IACrH,QAAQ,CAAC,sBAAsB,EAAE,IAAI,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;CACpG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAEpF"}

package/dist/features/feature-flags/types.js

@@ -0,0 +1,8 @@
+export const FEATURE_FLAG_PARTIAL = Symbol('featureFlag:partial');
+export function isFeatureFlagPartial(value) {
+    return typeof value === 'object' && value !== null && FEATURE_FLAG_PARTIAL in value;
+}
+export function isFeatureFlagComponent(value) {
+    return typeof value === 'object' && value !== null && '__featureFlagComponent' in value;
+}
+//# sourceMappingURL=types.js.map

package/dist/features/feature-flags/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/feature-flags/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAiBlE,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,oBAAoB,IAAI,KAAK,CAAC;AACtF,CAAC;AAaD,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,wBAAwB,IAAI,KAAK,CAAC;AAC1F,CAAC"}

package/dist/features/index.d.ts

@@ -0,0 +1,6 @@
+export * from './config/index.js';
+export * from './channel/index.js';
+export * from './lock/index.js';
+export * from './contract/index.js';
+export * from './memory/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAEA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/features/index.js

@@ -0,0 +1,7 @@
+// Features - Optional capabilities
+export * from './config/index.js';
+export * from './channel/index.js';
+export * from './lock/index.js';
+export * from './contract/index.js';
+export * from './memory/index.js';
+//# sourceMappingURL=index.js.map

package/dist/features/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/features/lock/index.d.ts

@@ -0,0 +1,4 @@
+export type { Lock, LockMetadata, LockOptions, LockProvider, LockService, } from './types.js';
+export { isLocked } from './types.js';
+export { LockServiceDef, AbstractLockProvider, LockAcquisitionError, DoubleLockError, LockReleasedError, InvalidLockKeyError, runWithLockTracking, getHeldLocks, _registerHeldLock, _unregisterHeldLock, } from './lock-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/lock/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/lock/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC"}

package/dist/features/lock/index.js

@@ -0,0 +1,4 @@
+export { isLocked } from './types.js';
+// Service
+export { LockServiceDef, AbstractLockProvider, LockAcquisitionError, DoubleLockError, LockReleasedError, InvalidLockKeyError, runWithLockTracking, getHeldLocks, _registerHeldLock, _unregisterHeldLock, } from './lock-service.js';
+//# sourceMappingURL=index.js.map

package/dist/features/lock/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/lock/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,UAAU;AACV,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC"}