domainkit 0.19.0 → 0.20.1

package/dist/types/Verify.d.ts

@@ -73,7 +73,11 @@ export interface Interface {
         readonly domain: string;
         readonly requirements?: ReadonlyArray<DnsRecord.Model>;
     }) => Fx<Readiness>;
-    /** Merge host evidence into stored readiness without re-observing DNS. */
+    /**
+     * Merge host evidence into stored readiness without re-observing DNS. Before the first `observe`
+     * the readiness has no requirements, so it is never `ready`: `failed` when a host signal failed,
+     * otherwise `pending` with `nextCheckAt` set for the first observation.
+     */
     readonly attachEvidence: (input: {
         readonly domain: string;
         readonly evidence: ReadonlyArray<HostEvidence>;
@@ -162,7 +166,7 @@ declare const Observer_base: Context.Reference<ObserverShape>;
  */
 export declare class Observer extends Observer_base {
 }
-/** A requirement is satisfied by an exact match; an exclusive one is contradicted by any same-set record. */
+/** A requirement is satisfied only when its exact match also meets its safety constraints. */
 export declare const statusAgainst: (record: DnsRecord.Model, observed: ReadonlyArray<DnsRecord.Observed>) => Storage.RequirementStatus;
 export declare const make: Effect.Effect<Interface, never, Storage.Service | Connect.Service | Resolver.Service>;
 export declare const layer: Layer.Layer<Service, never, Storage.Service | Connect.Service | Resolver.Service>;

package/dist/types/internal/reconciliation.d.ts

@@ -0,0 +1,11 @@
+import * as DnsRecord from "../DnsRecord.ts";
+import type * as Plan from "../Plan.ts";
+interface Collision {
+    readonly reason: Plan.Conflict["reason"];
+    readonly existing: ReadonlyArray<DnsRecord.Observed>;
+}
+/** Safety constraints precede exact matches in both planning and observation. */
+export declare const collision: (record: DnsRecord.Model, observed: ReadonlyArray<DnsRecord.Observed>) => Collision | undefined;
+/** Both sides' constraints apply, regardless of requirement order or canonical sorting. */
+export declare const projectedCollision: (record: DnsRecord.Model, requirements: ReadonlyArray<DnsRecord.Model>) => Collision | undefined;
+export {};

package/dist/types/internal/spf.d.ts

@@ -0,0 +1,2 @@
+/** RFC 7208 version selection only; full SPF policy validation belongs to the host. */
+export declare const isSpf: (value: string) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domainkit",
-  "version": "0.19.0",
+  "version": "0.20.1",
   "description": "Build reviewable DNS plans for custom domains in TypeScript",
   "keywords": [
     "custom-domains",
@@ -11,7 +11,7 @@
     "effect",
     "typescript"
   ],
-  "homepage": "https://github.com/AryaLabsHQ/domainkit#readme",
+  "homepage": "https://domain-kit.dev",
   "bugs": {
     "url": "https://github.com/AryaLabsHQ/domainkit/issues"
   },
@@ -143,9 +143,9 @@
     "tldts": "^7.4.11"
   },
   "devDependencies": {
-    "@effect/vitest": "4.0.0-rc.117",
+    "@effect/vitest": "4.0.0",
     "@types/bun": "1.4.0",
-    "effect": "4.0.0-rc.117",
+    "effect": "4.0.0",
     "miniflare": "3.20250718.3",
     "tsdown": "0.22.14",
     "typescript": "7.0.2",
@@ -153,7 +153,7 @@
     "vitest": "5.0.1"
   },
   "peerDependencies": {
-    "effect": ">=4.0.0-rc.117 <5.0.0"
+    "effect": ">=4.0.0 <5.0.0"
   },
   "engines": {
     "node": ">=24.10.0"