@toggld/node 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,90 @@
+# @toggld/node
+
+The Toggld SDK for Node.js. Evaluate feature flags from your backend against the
+Toggld flag API.
+
+Two API surfaces ship from one implementation:
+
+- **`@toggld/node`** — a plain Promise API. No Effect types in any signature.
+- **`@toggld/node/effect`** — the native [Effect](https://effect.website) API:
+  the client as a service + `Layer`.
+
+> **Remote evaluation only (for now).** Every call hits the flag API, which
+> evaluates the flag against your context and returns the resolved value
+> (OpenFeature "remote evaluation" over the OFREP endpoints). Local in-process
+> evaluation with a background definition sync — the `@toggld/engine` path — is a
+> later milestone; see [ADR-0001](../../docs/adr/0001-packaging-and-sdk-strategy.md).
+
+## Install
+
+```bash
+pnpm add @toggld/node
+```
+
+## Promise API
+
+```ts
+import { ToggldClient } from "@toggld/node"
+
+const client = await ToggldClient.create({
+  sdkKey: process.env.TOGGLD_SDK_KEY!, // an evaluation API key
+  endpoint: "https://your-flag-api.example.com",
+})
+
+// Typed getters — return the default on any error, never throw.
+const on = await client.getBooleanValue("new-checkout", false, {
+  targetingKey: "user-123",
+  plan: "premium",
+})
+
+// Full OpenFeature evaluation details.
+const details = await client.getStringDetails("theme", "light", { targetingKey: "user-123" })
+//    ^ { flagKey, value, variant, reason, errorCode, errorMessage, flagMetadata }
+
+// All flags for the environment in one request.
+const everything = await client.evaluateAll({ targetingKey: "user-123" })
+
+await client.close() // releases the underlying runtime
+```
+
+Getters exist for each flag type: `getBooleanValue` / `getBooleanDetails`,
+`getStringValue` / `…`, `getNumberValue` / `…`, and `getObjectValue<T>` / `…`.
+
+## Effect API
+
+```ts
+import { Effect } from "effect"
+import { ToggldClient, layer } from "@toggld/node/effect"
+
+const program = Effect.gen(function* () {
+  const flags = yield* ToggldClient
+  return yield* flags.getBooleanValue("new-checkout", false, { targetingKey: "user-123" })
+})
+
+program.pipe(
+  Effect.provide(layer({ sdkKey, endpoint })),
+  Effect.runPromise,
+)
+```
+
+The `layer` is self-contained — it wires its own HTTP backend, so you only
+provide this one layer. Lifecycle (the HTTP client) is managed by the enclosing
+scope.
+
+## Options
+
+| Option           | Type                  | Default          | Notes                                                            |
+| ---------------- | --------------------- | ---------------- | ---------------------------------------------------------------- |
+| `sdkKey`         | `string`              | —                | Evaluation (or management) API key; sent as `Bearer`.            |
+| `endpoint`       | `string`              | —                | Base URL of the flag API, no trailing path.                      |
+| `defaultContext` | `EvaluationContext`   | `{}`             | Merged under per-call context (per-call attributes win).         |
+| `timeoutMs`      | `number`              | `5000`           | Per-request timeout.                                             |
+| `fetch`          | `typeof fetch`        | `globalThis.fetch` | Custom fetch (tests, proxies, instrumentation).               |
+
+## Error semantics
+
+Evaluation never throws. On a network failure, timeout, unknown flag, server
+error, or a value whose type doesn't match the requested getter, the call
+resolves to your **default value**. The `*Details` methods carry `reason:
+"ERROR"` and an OpenFeature `errorCode` (`FLAG_NOT_FOUND`, `TYPE_MISMATCH`,
+`TARGETING_KEY_MISSING`, `PARSE_ERROR`, `GENERAL`, …) describing what happened.

package/dist/core-zMjaOru1.mjs

@@ -0,0 +1,549 @@
+import { Context, Duration, Effect, Layer, Schema } from "effect";
+import { FetchHttpClient, HttpClient, HttpClientRequest, HttpClientResponse } from "effect/unstable/http";
+//#region ../spec/src/index.ts
+/** True when `value` is assignable to a flag declared as `type`. */
+const valueMatchesType = (value, type) => {
+	switch (type) {
+		case "boolean": return typeof value === "boolean";
+		case "string": return typeof value === "string";
+		case "number": return typeof value === "number" && Number.isFinite(value);
+		case "object": return typeof value === "object" && value !== null;
+	}
+};
+//#endregion
+//#region ../schema/src/audit.ts
+/**
+* Audit log wire contract (ADR-0009). Every management/control-plane mutation is
+* recorded as one append-only {@link AuditEvent}; a tenant reads its own trail
+* over `GET /api/v1/audit-log`. Evaluation (OFREP) reads are deliberately *not*
+* audited — this is a record of configuration *changes*, not traffic.
+*/
+/** Who performed the change. See the server's `Actor` for how each id is sourced. */
+const AuditActor = Schema.Struct({
+	type: Schema.Literals([
+		"apiKey",
+		"user",
+		"service"
+	]),
+	id: Schema.String
+});
+/**
+* Closed vocabulary of audited actions — a closed set (not free text) so filters
+* and downstream exports stay stable as resources are added. `flag.update` covers
+* both replace (PUT) and patch (PATCH); the before/after states show what moved.
+*/
+const AuditAction = Schema.Literals([
+	"flag.create",
+	"flag.update",
+	"flag.delete",
+	"environment.create",
+	"environment.delete",
+	"apiKey.create",
+	"apiKey.revoke",
+	"tenant.create",
+	"tenant.update"
+]);
+/** The kind of resource an event concerns; pairs with `resourceId`. */
+const AuditResourceType = Schema.Literals([
+	"flag",
+	"environment",
+	"apiKey",
+	"tenant"
+]);
+Schema.Struct({
+	id: Schema.String,
+	/** Owning tenant; null only for control-plane events (tenant provisioning). */
+	tenantId: Schema.NullOr(Schema.String),
+	/** The environment touched; null for tenant-wide / definition-level / control-plane events. */
+	environmentId: Schema.NullOr(Schema.String),
+	actor: AuditActor,
+	action: AuditAction,
+	resourceType: AuditResourceType,
+	/** Flag key, environment id, API-key id, or tenant id. */
+	resourceId: Schema.String,
+	before: Schema.NullOr(Schema.Unknown),
+	after: Schema.NullOr(Schema.Unknown),
+	/** Non-authoritative request context (request id, source ip, …); empty in v0. */
+	metadata: Schema.Record(Schema.String, Schema.Unknown),
+	/** ISO 8601 timestamp the change was recorded. */
+	occurredAt: Schema.String
+});
+//#endregion
+//#region ../schema/src/auth.ts
+/**
+* Authorization role carried by an API key.
+*
+* - `management` — full CRUD on the tenant's flags, plus evaluation.
+* - `evaluation` — read-only evaluation (OFREP) of the tenant's flags.
+*/
+const Role = Schema.Literals(["management", "evaluation"]);
+Schema.Struct({
+	id: Schema.String,
+	name: Schema.String,
+	createdAt: Schema.String,
+	/**
+	* Max number of flag *definitions* the tenant may hold; `null` = unlimited.
+	* The free tier is 10 (the DB column default). The flag API treats this as an
+	* opaque number — the web app owns the plan→limit mapping and pushes changes
+	* over the control plane (provision + PATCH). Enforced in `FlagService.create`.
+	*/
+	flagLimit: Schema.NullOr(Schema.Int)
+});
+Schema.Struct({
+	id: Schema.String,
+	tenantId: Schema.String,
+	/** Stable slug, unique within the tenant (e.g. `production`). */
+	key: Schema.String,
+	name: Schema.String,
+	createdAt: Schema.String
+});
+/** Body for creating an environment (POST /admin/v1/tenants/:tenantId/environments). */
+const CreateEnvironmentInput = Schema.Struct({
+	key: Schema.String.check(Schema.isMinLength(1)),
+	name: Schema.String.check(Schema.isMinLength(1))
+});
+/**
+* Public view of an API key — safe to list. Never includes the secret token or
+* its hash; only a non-secret prefix for human identification.
+*/
+const ApiKeyInfo = Schema.Struct({
+	id: Schema.String,
+	tenantId: Schema.String,
+	/** The single environment this key is scoped to. */
+	environmentId: Schema.String,
+	name: Schema.optionalKey(Schema.String),
+	role: Role,
+	prefix: Schema.String,
+	createdAt: Schema.String
+});
+Schema.Struct({
+	...ApiKeyInfo.fields,
+	token: Schema.String
+});
+Schema.Struct({
+	id: Schema.optionalKey(Schema.String.check(Schema.isMinLength(1))),
+	name: Schema.String.check(Schema.isMinLength(1)),
+	environments: Schema.optionalKey(Schema.Array(CreateEnvironmentInput)),
+	/** Flag cap for the new tenant; omitted → the free-tier default (10). */
+	flagLimit: Schema.optionalKey(Schema.Int)
+});
+Schema.Struct({
+	name: Schema.optionalKey(Schema.String.check(Schema.isMinLength(1))),
+	flagLimit: Schema.optionalKey(Schema.NullOr(Schema.Int))
+});
+Schema.Struct({
+	role: Role,
+	name: Schema.optionalKey(Schema.String),
+	environment: Schema.optionalKey(Schema.String.check(Schema.isMinLength(1)))
+});
+//#endregion
+//#region ../schema/src/value.ts
+/**
+* The OpenFeature flag value types. Every flag declares one of these; variant
+* values and resolved values are validated against it.
+*
+* @see https://openfeature.dev/specification/types
+*/
+const FlagType = Schema.Literals([
+	"boolean",
+	"string",
+	"number",
+	"object"
+]);
+/**
+* A resolved flag value. OpenFeature permits `boolean | string | number |
+* structure`; we store the union as JSON, which also covers arrays and null
+* for "object" typed flags.
+*/
+const FlagValue = Schema.Json;
+/**
+* Flag metadata: "a structure supporting the definition of arbitrary
+* properties, with keys of type string, and values of type boolean, string,
+* or number." (Requirement 2.2.10)
+*/
+const MetadataValue = Schema.Union([
+	Schema.String,
+	Schema.Finite,
+	Schema.Boolean
+]);
+const FlagMetadata = Schema.Record(Schema.String, MetadataValue);
+//#endregion
+//#region ../schema/src/context.ts
+/**
+* An OpenFeature evaluation context: an optional `targetingKey` "identifying
+* the subject of the flag evaluation" (Requirement 3.1.1) plus arbitrary
+* custom fields (Requirement 3.1.2). We accept any JSON-valued attributes.
+*/
+const EvaluationContext = Schema.Record(Schema.String, FlagValue);
+Schema.ErrorClass("FlagNotFound")({
+	_tag: Schema.tag("FlagNotFound"),
+	flagKey: Schema.String,
+	message: Schema.String
+});
+Schema.ErrorClass("FlagAlreadyExists")({
+	_tag: Schema.tag("FlagAlreadyExists"),
+	flagKey: Schema.String,
+	message: Schema.String
+});
+Schema.ErrorClass("FlagValidationError")({
+	_tag: Schema.tag("FlagValidationError"),
+	flagKey: Schema.String,
+	issues: Schema.Array(Schema.String),
+	message: Schema.String
+});
+Schema.ErrorClass("FlagLimitExceeded")({
+	_tag: Schema.tag("FlagLimitExceeded"),
+	/** The tenant's current flag cap. */
+	limit: Schema.Int,
+	/** How many flags the tenant has now (>= limit). */
+	current: Schema.Int,
+	message: Schema.String
+});
+Schema.ErrorClass("Unauthorized")({
+	_tag: Schema.tag("Unauthorized"),
+	message: Schema.String
+});
+Schema.ErrorClass("Forbidden")({
+	_tag: Schema.tag("Forbidden"),
+	message: Schema.String
+});
+Schema.ErrorClass("TenantNotFound")({
+	_tag: Schema.tag("TenantNotFound"),
+	tenantId: Schema.String,
+	message: Schema.String
+});
+Schema.ErrorClass("TenantAlreadyExists")({
+	_tag: Schema.tag("TenantAlreadyExists"),
+	tenantId: Schema.String,
+	message: Schema.String
+});
+Schema.ErrorClass("EnvironmentNotFound")({
+	_tag: Schema.tag("EnvironmentNotFound"),
+	environment: Schema.String,
+	message: Schema.String
+});
+Schema.ErrorClass("EnvironmentAlreadyExists")({
+	_tag: Schema.tag("EnvironmentAlreadyExists"),
+	environment: Schema.String,
+	message: Schema.String
+});
+Schema.ErrorClass("ApiKeyNotFound")({
+	_tag: Schema.tag("ApiKeyNotFound"),
+	keyId: Schema.String,
+	message: Schema.String
+});
+//#endregion
+//#region ../schema/src/flag.ts
+/**
+* Operators usable in a targeting condition. Comparisons coerce sensibly:
+* numeric operators require numbers, string operators require strings, and
+* `in`/`notIn` test membership in an array literal.
+*/
+const Operator = Schema.Literals([
+	"eq",
+	"ne",
+	"in",
+	"notIn",
+	"lt",
+	"lte",
+	"gt",
+	"gte",
+	"contains",
+	"startsWith",
+	"endsWith",
+	"exists",
+	"notExists"
+]);
+/**
+* A single targeting condition tested against an attribute of the evaluation
+* context (e.g. `targetingKey`, `email`, `plan`). All conditions in a rule are
+* ANDed together.
+*/
+const Condition = Schema.Struct({
+	attribute: Schema.String,
+	operator: Operator,
+	/** Comparison operand. Ignored for `exists`/`notExists`. */
+	value: Schema.optionalKey(FlagValue)
+});
+/** A weighted slice of a percentage rollout. */
+const Split = Schema.Struct({
+	variant: Schema.String,
+	/** Relative weight; the engine normalises weights across all splits. */
+	weight: Schema.Finite.check(Schema.isGreaterThanOrEqualTo(0))
+});
+/** Serve a single fixed variant when the rule matches → `TARGETING_MATCH`. */
+const ServeVariant = Schema.Struct({
+	type: Schema.Literal("variant"),
+	variant: Schema.String
+});
+/**
+* Serve a deterministic percentage rollout when the rule matches → `SPLIT`.
+* Bucketing is consistent for a given subject (`bucketBy`, default
+* `targetingKey`) so a subject always lands in the same slice.
+*/
+const ServeRollout = Schema.Struct({
+	type: Schema.Literal("rollout"),
+	bucketBy: Schema.optionalKey(Schema.String),
+	splits: Schema.Array(Split)
+});
+const Serve = Schema.Union([ServeVariant, ServeRollout]);
+/** An ordered targeting rule. The first rule whose conditions all match wins. */
+const Rule = Schema.Struct({
+	id: Schema.String,
+	description: Schema.optionalKey(Schema.String),
+	/** ANDed conditions. An empty list always matches (useful as a catch-all). */
+	conditions: Schema.Array(Condition),
+	serve: Serve
+});
+/**
+* A feature flag definition.
+*
+* Evaluation order: if `enabled` is false → serve `offVariant` (default
+* `defaultVariant`) with reason `DISABLED`; otherwise walk `targeting` in
+* order and serve the first matching rule (`TARGETING_MATCH`/`SPLIT`); if no
+* rule matches, serve `defaultVariant` with reason `STATIC`.
+*/
+const Flag = Schema.Struct({
+	key: Schema.String,
+	name: Schema.optionalKey(Schema.String),
+	description: Schema.optionalKey(Schema.String),
+	type: FlagType,
+	enabled: Schema.Boolean,
+	/** Named values; every served variant name must be a key here. */
+	variants: Schema.Record(Schema.String, FlagValue),
+	/** Variant served on a normal evaluation with no targeting match. */
+	defaultVariant: Schema.String,
+	/** Variant served when the flag is disabled. Defaults to `defaultVariant`. */
+	offVariant: Schema.optionalKey(Schema.String),
+	targeting: Schema.Array(Rule),
+	metadata: FlagMetadata,
+	createdAt: Schema.String,
+	updatedAt: Schema.String
+});
+/**
+* Freeform organization labels for a flag (ADR-0008). A flag may carry any
+* number; they group/filter flags in the dashboard and have **no** effect on
+* evaluation. Deliberately separate from the spec `Flag` (and `metadata`) so
+* they never reach the OFREP wire or the engine.
+*/
+const Tags = Schema.Array(Schema.String.check(Schema.isMinLength(1)));
+Schema.Struct({
+	...Flag.fields,
+	tags: Tags
+});
+//#endregion
+//#region ../schema/src/resolution.ts
+/**
+* Resolution reasons. The provider "SHOULD populate the resolution details
+* structure's reason field with STATIC, DEFAULT, TARGETING_MATCH, SPLIT,
+* CACHED, DISABLED, UNKNOWN, STALE, ERROR or some other string."
+* (Requirement 2.2.5)
+*/
+const Reason = Schema.Literals([
+	"STATIC",
+	"DEFAULT",
+	"TARGETING_MATCH",
+	"SPLIT",
+	"CACHED",
+	"DISABLED",
+	"UNKNOWN",
+	"STALE",
+	"ERROR"
+]);
+/**
+* OpenFeature error codes.
+* @see https://openfeature.dev/specification/types
+*/
+const ErrorCode = Schema.Literals([
+	"PROVIDER_NOT_READY",
+	"PROVIDER_FATAL",
+	"FLAG_NOT_FOUND",
+	"PARSE_ERROR",
+	"TYPE_MISMATCH",
+	"TARGETING_KEY_MISSING",
+	"INVALID_CONTEXT",
+	"GENERAL"
+]);
+Schema.Struct({ context: Schema.optionalKey(EvaluationContext) });
+/** A successful single/bulk evaluation result. */
+const OfrepSuccess = Schema.Struct({
+	key: Schema.String,
+	value: FlagValue,
+	reason: Reason,
+	variant: Schema.optionalKey(Schema.String),
+	metadata: Schema.optionalKey(FlagMetadata)
+});
+/** A per-flag failure embedded in a bulk response. */
+const OfrepFailure = Schema.Struct({
+	key: Schema.String,
+	errorCode: ErrorCode,
+	errorDetails: Schema.optionalKey(Schema.String),
+	metadata: Schema.optionalKey(FlagMetadata)
+});
+/** Bulk evaluation response: a mixed list of successes and failures. */
+const OfrepBulkResponse = Schema.Struct({
+	flags: Schema.Array(Schema.Union([OfrepSuccess, OfrepFailure])),
+	metadata: Schema.optionalKey(FlagMetadata)
+});
+Schema.ErrorClass("OfrepFlagNotFound")({
+	key: Schema.String,
+	errorCode: Schema.Literal("FLAG_NOT_FOUND"),
+	errorDetails: Schema.optionalKey(Schema.String)
+});
+Schema.ErrorClass("OfrepEvaluationError")({
+	key: Schema.String,
+	errorCode: ErrorCode,
+	errorDetails: Schema.optionalKey(Schema.String)
+});
+Schema.Struct({
+	key: Schema.String.check(Schema.isMinLength(1)),
+	name: Schema.optionalKey(Schema.String),
+	description: Schema.optionalKey(Schema.String),
+	type: FlagType,
+	enabled: Schema.optionalKey(Schema.Boolean),
+	variants: Schema.Record(Schema.String, FlagValue),
+	defaultVariant: Schema.String,
+	offVariant: Schema.optionalKey(Schema.String),
+	targeting: Schema.optionalKey(Schema.Array(Rule)),
+	metadata: Schema.optionalKey(FlagMetadata),
+	/** Freeform organization labels (ADR-0008). Normalized server-side. */
+	tags: Schema.optionalKey(Tags)
+});
+Schema.Struct({
+	name: Schema.optionalKey(Schema.String),
+	description: Schema.optionalKey(Schema.String),
+	type: FlagType,
+	enabled: Schema.optionalKey(Schema.Boolean),
+	variants: Schema.Record(Schema.String, FlagValue),
+	defaultVariant: Schema.String,
+	offVariant: Schema.optionalKey(Schema.String),
+	targeting: Schema.optionalKey(Schema.Array(Rule)),
+	metadata: Schema.optionalKey(FlagMetadata),
+	tags: Schema.optionalKey(Tags)
+});
+Schema.Struct({
+	name: Schema.optionalKey(Schema.String),
+	description: Schema.optionalKey(Schema.String),
+	type: Schema.optionalKey(FlagType),
+	enabled: Schema.optionalKey(Schema.Boolean),
+	variants: Schema.optionalKey(Schema.Record(Schema.String, FlagValue)),
+	defaultVariant: Schema.optionalKey(Schema.String),
+	offVariant: Schema.optionalKey(Schema.String),
+	targeting: Schema.optionalKey(Schema.Array(Rule)),
+	metadata: Schema.optionalKey(FlagMetadata),
+	tags: Schema.optionalKey(Tags)
+});
+//#endregion
+//#region src/internal/core.ts
+/**
+* The Effect core of the Toggld Node SDK — a remote-evaluation client over the
+* server's OFREP endpoints.
+*
+* This is the canonical implementation; `../index.ts` (the plain Promise API) is
+* a thin facade that runs this under a `ManagedRuntime`. The SDK performs **no
+* local evaluation** — every call hits the flag API, which evaluates the flag
+* against the supplied context and returns the resolved value (OpenFeature
+* "remote evaluation"). Local in-process evaluation via `@toggld/engine` is a
+* later milestone (see ADR-0001).
+*
+* OpenFeature semantics: evaluation never throws. Any failure — network error,
+* timeout, unknown flag, a server-reported error, or a value whose type doesn't
+* match the requested getter — resolves to the caller's default value with the
+* details carrying `reason: "ERROR"` and an `errorCode`.
+*/
+const DEFAULT_TIMEOUT_MS = 5e3;
+const isBoolean = (v) => typeof v === "boolean";
+const isString = (v) => typeof v === "string";
+const isNumber = (v) => typeof v === "number" && Number.isFinite(v);
+const isObject = (v) => valueMatchesType(v, "object");
+const okDetails = (key, s) => ({
+	flagKey: key,
+	value: s.value,
+	variant: s.variant,
+	reason: s.reason,
+	errorCode: void 0,
+	errorMessage: void 0,
+	flagMetadata: s.metadata ?? {}
+});
+const wireErrorDetails = (fallback, e) => ({
+	flagKey: e.key,
+	value: fallback,
+	variant: void 0,
+	reason: "ERROR",
+	errorCode: e.errorCode,
+	errorMessage: e.errorDetails,
+	flagMetadata: e.metadata ?? {}
+});
+const errorDetails = (key, value, errorCode, errorMessage, flagMetadata = {}) => ({
+	flagKey: key,
+	value,
+	variant: void 0,
+	reason: "ERROR",
+	errorCode,
+	errorMessage,
+	flagMetadata
+});
+/** A readable message for an arbitrary thrown/failed value. */
+const describe = (e) => typeof e === "object" && e !== null && "message" in e && typeof e.message === "string" ? e.message : String(e);
+/** Map a transport/decoding failure to an OpenFeature error code. */
+const codeFor = (e) => typeof e === "object" && e !== null && "_tag" in e && e._tag === "SchemaError" ? "PARSE_ERROR" : "GENERAL";
+/**
+* The Toggld client as an Effect service. Build a {@link layer} from options and
+* compose it into your runtime, then `yield* ToggldClient` to evaluate flags.
+*/
+var ToggldClient = class extends Context.Service()("@toggld/node/ToggldClient") {};
+const make = (options) => Effect.gen(function* () {
+	const base = yield* HttpClient.HttpClient;
+	const timeout = Duration.millis(options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+	const http = base.pipe(HttpClient.mapRequest(HttpClientRequest.prependUrl(options.endpoint)), HttpClient.mapRequest(HttpClientRequest.bearerToken(options.sdkKey)));
+	const mergedContext = (context) => ({
+		...options.defaultContext,
+		...context
+	});
+	const decode = HttpClientResponse.schemaBodyJson;
+	const evaluate = (key, defaultValue, context) => Effect.gen(function* () {
+		const request = HttpClientRequest.post(`/ofrep/v1/evaluate/flags/${encodeURIComponent(key)}`).pipe(HttpClientRequest.bodyJsonUnsafe({ context: mergedContext(context) }));
+		const response = yield* http.execute(request);
+		return yield* HttpClientResponse.matchStatus(response, {
+			"2xx": (r) => Effect.map(decode(OfrepSuccess)(r), (s) => okDetails(key, s)),
+			"4xx": (r) => Effect.map(decode(OfrepFailure)(r), (e) => wireErrorDetails(defaultValue, e)),
+			orElse: (r) => Effect.succeed(errorDetails(key, defaultValue, "GENERAL", `Unexpected response status ${r.status}`))
+		});
+	}).pipe(Effect.timeout(timeout), Effect.catch((error) => Effect.succeed(errorDetails(key, defaultValue, codeFor(error), describe(error)))));
+	const evaluateAll = (context) => Effect.gen(function* () {
+		const request = HttpClientRequest.post("/ofrep/v1/evaluate/flags").pipe(HttpClientRequest.bodyJsonUnsafe({ context: mergedContext(context) }));
+		const response = yield* http.execute(request);
+		return (yield* HttpClientResponse.matchStatus(response, {
+			"2xx": (r) => decode(OfrepBulkResponse)(r),
+			orElse: (r) => Effect.fail(/* @__PURE__ */ new Error(`Unexpected response status ${r.status}`))
+		})).flags.map((entry) => "errorCode" in entry ? wireErrorDetails(null, entry) : okDetails(entry.key, entry));
+	}).pipe(Effect.timeout(timeout), Effect.catch(() => Effect.succeed([])));
+	/** Resolve, then enforce the requested value type (else `TYPE_MISMATCH`). */
+	const typed = (key, defaultValue, context, type, guard) => Effect.map(evaluate(key, defaultValue, context), (d) => {
+		if (d.errorCode !== void 0) return d;
+		if (guard(d.value)) return d;
+		return errorDetails(key, defaultValue, "TYPE_MISMATCH", `Flag '${key}' value is not of type ${type}`, d.flagMetadata);
+	});
+	const valueOf = (details) => Effect.map(details, (d) => d.value);
+	return {
+		evaluate,
+		evaluateAll,
+		getBooleanDetails: (key, defaultValue, context) => typed(key, defaultValue, context, "boolean", isBoolean),
+		getBooleanValue: (key, defaultValue, context) => valueOf(typed(key, defaultValue, context, "boolean", isBoolean)),
+		getStringDetails: (key, defaultValue, context) => typed(key, defaultValue, context, "string", isString),
+		getStringValue: (key, defaultValue, context) => valueOf(typed(key, defaultValue, context, "string", isString)),
+		getNumberDetails: (key, defaultValue, context) => typed(key, defaultValue, context, "number", isNumber),
+		getNumberValue: (key, defaultValue, context) => valueOf(typed(key, defaultValue, context, "number", isNumber)),
+		getObjectDetails: (key, defaultValue, context) => typed(key, defaultValue, context, "object", isObject),
+		getObjectValue: (key, defaultValue, context) => valueOf(typed(key, defaultValue, context, "object", isObject))
+	};
+});
+/** The HttpClient layer, optionally backed by a caller-supplied `fetch`. */
+const httpLayer = (fetchImpl) => fetchImpl ? FetchHttpClient.layer.pipe(Layer.provide(Layer.succeed(FetchHttpClient.Fetch, fetchImpl))) : FetchHttpClient.layer;
+/**
+* A self-contained `Layer` providing {@link ToggldClient} — it wires its own
+* HTTP backend, so Effect users need only provide this one layer.
+*/
+const layer = (options) => Layer.effect(ToggldClient, make(options)).pipe(Layer.provide(httpLayer(options.fetch)));
+//#endregion
+export { layer as n, ToggldClient as t };

package/dist/effect.d.mts

@@ -0,0 +1,32 @@
+import { a as FlagMetadata, i as EvaluationContext, n as ToggldClientOptions, o as FlagValue, r as ErrorCode, s as Reason, t as EvaluationDetails } from "./types-RmWNnA7-.mjs";
+import { Context, Effect, Layer } from "effect";
+
+//#region src/internal/core.d.ts
+/** The evaluation surface of a Toggld client. Every method is non-failing. */
+interface ToggldClientShape {
+  /** Resolve a flag, returning full details with an untyped (JSON) value. */
+  readonly evaluate: (key: string, defaultValue: FlagValue, context?: EvaluationContext) => Effect.Effect<EvaluationDetails<FlagValue>>;
+  /** Resolve every flag for the environment in one request (OFREP bulk). */
+  readonly evaluateAll: (context?: EvaluationContext) => Effect.Effect<ReadonlyArray<EvaluationDetails<FlagValue>>>;
+  readonly getBooleanValue: (key: string, defaultValue: boolean, context?: EvaluationContext) => Effect.Effect<boolean>;
+  readonly getBooleanDetails: (key: string, defaultValue: boolean, context?: EvaluationContext) => Effect.Effect<EvaluationDetails<boolean>>;
+  readonly getStringValue: (key: string, defaultValue: string, context?: EvaluationContext) => Effect.Effect<string>;
+  readonly getStringDetails: (key: string, defaultValue: string, context?: EvaluationContext) => Effect.Effect<EvaluationDetails<string>>;
+  readonly getNumberValue: (key: string, defaultValue: number, context?: EvaluationContext) => Effect.Effect<number>;
+  readonly getNumberDetails: (key: string, defaultValue: number, context?: EvaluationContext) => Effect.Effect<EvaluationDetails<number>>;
+  readonly getObjectValue: <T extends FlagValue>(key: string, defaultValue: T, context?: EvaluationContext) => Effect.Effect<T>;
+  readonly getObjectDetails: <T extends FlagValue>(key: string, defaultValue: T, context?: EvaluationContext) => Effect.Effect<EvaluationDetails<T>>;
+}
+declare const ToggldClient_base: Context.ServiceClass<ToggldClient, "@toggld/node/ToggldClient", ToggldClientShape>;
+/**
+ * The Toggld client as an Effect service. Build a {@link layer} from options and
+ * compose it into your runtime, then `yield* ToggldClient` to evaluate flags.
+ */
+declare class ToggldClient extends ToggldClient_base {}
+/**
+ * A self-contained `Layer` providing {@link ToggldClient} — it wires its own
+ * HTTP backend, so Effect users need only provide this one layer.
+ */
+declare const layer: (options: ToggldClientOptions) => Layer.Layer<ToggldClient>;
+//#endregion
+export { type ErrorCode, type EvaluationContext, type EvaluationDetails, type FlagMetadata, type FlagValue, type Reason, ToggldClient, type ToggldClientOptions, type ToggldClientShape, layer };

package/dist/effect.mjs

@@ -0,0 +1,2 @@
+import { n as layer, t as ToggldClient } from "./core-zMjaOru1.mjs";
+export { ToggldClient, layer };

package/dist/index.d.mts

@@ -0,0 +1,30 @@
+import { a as FlagMetadata, i as EvaluationContext, n as ToggldClientOptions, o as FlagValue, r as ErrorCode, s as Reason, t as EvaluationDetails } from "./types-RmWNnA7-.mjs";
+
+//#region src/index.d.ts
+/**
+ * A Toggld client backed by a private Effect runtime. Create one with {@link
+ * ToggldClient.create} and {@link ToggldClient.close} it on shutdown to release
+ * the runtime.
+ */
+declare class ToggldClient {
+  #private;
+  private constructor();
+  /** Create a client. Resolves once the underlying runtime is ready. */
+  static create(options: ToggldClientOptions): Promise<ToggldClient>;
+  /** Resolve a flag, returning full details with an untyped (JSON) value. */
+  evaluate(key: string, defaultValue: FlagValue, context?: EvaluationContext): Promise<EvaluationDetails<FlagValue>>;
+  /** Resolve every flag for the environment in one request (OFREP bulk). */
+  evaluateAll(context?: EvaluationContext): Promise<ReadonlyArray<EvaluationDetails<FlagValue>>>;
+  getBooleanValue(key: string, defaultValue: boolean, context?: EvaluationContext): Promise<boolean>;
+  getBooleanDetails(key: string, defaultValue: boolean, context?: EvaluationContext): Promise<EvaluationDetails<boolean>>;
+  getStringValue(key: string, defaultValue: string, context?: EvaluationContext): Promise<string>;
+  getStringDetails(key: string, defaultValue: string, context?: EvaluationContext): Promise<EvaluationDetails<string>>;
+  getNumberValue(key: string, defaultValue: number, context?: EvaluationContext): Promise<number>;
+  getNumberDetails(key: string, defaultValue: number, context?: EvaluationContext): Promise<EvaluationDetails<number>>;
+  getObjectValue<T extends FlagValue>(key: string, defaultValue: T, context?: EvaluationContext): Promise<T>;
+  getObjectDetails<T extends FlagValue>(key: string, defaultValue: T, context?: EvaluationContext): Promise<EvaluationDetails<T>>;
+  /** Dispose the underlying runtime. The client is unusable afterwards. */
+  close(): Promise<void>;
+}
+//#endregion
+export { type ErrorCode, type EvaluationContext, type EvaluationDetails, type FlagMetadata, type FlagValue, type Reason, ToggldClient, type ToggldClientOptions };

package/dist/index.mjs

@@ -0,0 +1,77 @@
+import { n as layer, t as ToggldClient$1 } from "./core-zMjaOru1.mjs";
+import { ManagedRuntime } from "effect";
+//#region src/index.ts
+/**
+* `@toggld/node` — the default entry: a plain Promise API.
+*
+* Remote flag evaluation over the server's OFREP endpoints, with **no Effect in
+* any signature**. Internally it runs the Effect implementation from `./effect`
+* under a `ManagedRuntime`.
+*
+* ```ts
+* import { ToggldClient } from "@toggld/node"
+*
+* const client = await ToggldClient.create({ sdkKey, endpoint })
+* const on = await client.getBooleanValue("new-checkout", false, { targetingKey: "user-123" })
+* await client.close()
+* ```
+*
+* Evaluation never throws: any failure resolves to the supplied default value,
+* with the reason/error available via the `*Details` methods.
+*/
+/**
+* A Toggld client backed by a private Effect runtime. Create one with {@link
+* ToggldClient.create} and {@link ToggldClient.close} it on shutdown to release
+* the runtime.
+*/
+var ToggldClient = class ToggldClient {
+	#runtime;
+	#client;
+	constructor(runtime, client) {
+		this.#runtime = runtime;
+		this.#client = client;
+	}
+	/** Create a client. Resolves once the underlying runtime is ready. */
+	static async create(options) {
+		const runtime = ManagedRuntime.make(layer(options));
+		return new ToggldClient(runtime, await runtime.runPromise(ToggldClient$1));
+	}
+	/** Resolve a flag, returning full details with an untyped (JSON) value. */
+	evaluate(key, defaultValue, context) {
+		return this.#runtime.runPromise(this.#client.evaluate(key, defaultValue, context));
+	}
+	/** Resolve every flag for the environment in one request (OFREP bulk). */
+	evaluateAll(context) {
+		return this.#runtime.runPromise(this.#client.evaluateAll(context));
+	}
+	getBooleanValue(key, defaultValue, context) {
+		return this.#runtime.runPromise(this.#client.getBooleanValue(key, defaultValue, context));
+	}
+	getBooleanDetails(key, defaultValue, context) {
+		return this.#runtime.runPromise(this.#client.getBooleanDetails(key, defaultValue, context));
+	}
+	getStringValue(key, defaultValue, context) {
+		return this.#runtime.runPromise(this.#client.getStringValue(key, defaultValue, context));
+	}
+	getStringDetails(key, defaultValue, context) {
+		return this.#runtime.runPromise(this.#client.getStringDetails(key, defaultValue, context));
+	}
+	getNumberValue(key, defaultValue, context) {
+		return this.#runtime.runPromise(this.#client.getNumberValue(key, defaultValue, context));
+	}
+	getNumberDetails(key, defaultValue, context) {
+		return this.#runtime.runPromise(this.#client.getNumberDetails(key, defaultValue, context));
+	}
+	getObjectValue(key, defaultValue, context) {
+		return this.#runtime.runPromise(this.#client.getObjectValue(key, defaultValue, context));
+	}
+	getObjectDetails(key, defaultValue, context) {
+		return this.#runtime.runPromise(this.#client.getObjectDetails(key, defaultValue, context));
+	}
+	/** Dispose the underlying runtime. The client is unusable afterwards. */
+	close() {
+		return this.#runtime.dispose();
+	}
+};
+//#endregion
+export { ToggldClient };

package/dist/types-RmWNnA7-.d.mts

@@ -0,0 +1,85 @@
+//#region ../spec/src/index.d.ts
+/**
+ * A resolved flag value. OpenFeature permits `boolean | string | number |
+ * structure`; we model the union as JSON, which also covers arrays and null for
+ * "object" typed flags.
+ */
+type FlagValue = null | boolean | number | string | ReadonlyArray<FlagValue> | {
+  readonly [key: string]: FlagValue;
+};
+/**
+ * Flag metadata: "arbitrary properties, with keys of type string, and values of
+ * type boolean, string, or number." (Requirement 2.2.10)
+ */
+type MetadataValue = string | number | boolean;
+type FlagMetadata = {
+  readonly [key: string]: MetadataValue;
+};
+/**
+ * An OpenFeature evaluation context: an optional `targetingKey` identifying the
+ * subject (Requirement 3.1.1) plus arbitrary custom JSON-valued attributes
+ * (Requirement 3.1.2).
+ */
+type EvaluationContext = {
+  readonly [attribute: string]: FlagValue;
+};
+/**
+ * Resolution reasons. (Requirement 2.2.5)
+ */
+type Reason = "STATIC" | "DEFAULT" | "TARGETING_MATCH" | "SPLIT" | "CACHED" | "DISABLED" | "UNKNOWN" | "STALE" | "ERROR";
+/**
+ * OpenFeature error codes.
+ * @see https://openfeature.dev/specification/types
+ */
+type ErrorCode = "PROVIDER_NOT_READY" | "PROVIDER_FATAL" | "FLAG_NOT_FOUND" | "PARSE_ERROR" | "TYPE_MISMATCH" | "TARGETING_KEY_MISSING" | "INVALID_CONTEXT" | "GENERAL";
+//#endregion
+//#region src/internal/types.d.ts
+/** Configuration for a {@link https://toggld.io Toggld} client. */
+interface ToggldClientOptions {
+  /**
+   * An **evaluation** (or management) API key, sent as `Authorization: Bearer
+   * <sdkKey>`. The key is scoped to one tenant + environment server-side, so a
+   * client always evaluates against exactly that environment.
+   */
+  readonly sdkKey: string;
+  /**
+   * Base URL of the flag API, e.g. `https://toggld-api.example.workers.dev` or
+   * `http://localhost:3000` in local development. No trailing path — the client
+   * appends the OFREP routes (`/ofrep/v1/...`).
+   */
+  readonly endpoint: string;
+  /**
+   * Attributes merged into the evaluation context of **every** request, under
+   * any per-call context (per-call attributes win on key collision). Handy for
+   * process-wide dimensions such as `region` or `serviceVersion`.
+   */
+  readonly defaultContext?: EvaluationContext;
+  /** Per-request timeout in milliseconds. Default `5000`. */
+  readonly timeoutMs?: number;
+  /**
+   * Custom `fetch` implementation. Defaults to the global `fetch`. Useful for
+   * tests, proxies, or injecting retries/instrumentation.
+   */
+  readonly fetch?: typeof globalThis.fetch;
+}
+/**
+ * The outcome of evaluating a single flag — OpenFeature "evaluation details"
+ * with a value typed to the requested flag type. Mirrors {@link
+ * https://openfeature.dev/specification/sections/evaluation-details}.
+ *
+ * On any abnormal evaluation (network failure, unknown flag, type mismatch, a
+ * server-reported error) the call still resolves: `value` holds the caller's
+ * default, `reason` is `"ERROR"`, and `errorCode`/`errorMessage` describe what
+ * went wrong. Evaluation never throws.
+ */
+interface EvaluationDetails<T extends FlagValue> {
+  readonly flagKey: string;
+  readonly value: T;
+  readonly variant: string | undefined;
+  readonly reason: Reason;
+  readonly errorCode: ErrorCode | undefined;
+  readonly errorMessage: string | undefined;
+  readonly flagMetadata: FlagMetadata;
+}
+//#endregion
+export { FlagMetadata as a, EvaluationContext as i, ToggldClientOptions as n, FlagValue as o, ErrorCode as r, Reason as s, EvaluationDetails as t };

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@toggld/node",
+  "version": "0.1.0",
+  "description": "Toggld SDK for Node.js — local flag evaluation with a background definition sync. Plain Promise API by default; native Effect API via @toggld/node/effect.",
+  "license": "Apache-2.0",
+  "homepage": "https://toggld.io",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/toggld/toggld.git",
+    "directory": "packages/node"
+  },
+  "bugs": {
+    "url": "https://github.com/toggld/toggld/issues"
+  },
+  "keywords": [
+    "feature-flags",
+    "openfeature",
+    "toggld",
+    "effect"
+  ],
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./effect": {
+      "types": "./dist/effect.d.mts",
+      "default": "./dist/effect.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "effect": "4.0.0-beta.78"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.2",
+    "unrun": "^0.3.1",
+    "@toggld/schema": "0.1.0",
+    "@toggld/spec": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}