@airnauts/comments-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Airnauts
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @airnauts/comments-core
+
+Framework-agnostic core for the [Airnauts commenting tool](https://github.com/Airnauts/commenting-tool): zod schemas,
+page-key normalization, the scoring/threshold policy, and the OpenAPI contract.
+
+Most consumers depend on this transitively via `@airnauts/comments-client` or
+`@airnauts/comments-server` rather than installing it directly.
+
+## Install
+
+```bash
+pnpm add @airnauts/comments-core
+```
+
+## License
+
+MIT © Airnauts

package/dist/anchor/decide.d.ts

@@ -0,0 +1,15 @@
+import type { ScoreResult } from './score';
+import { type Thresholds } from './weights';
+export type Decision<T> = {
+    kind: 'anchored';
+    winner: T;
+    score: ScoreResult;
+} | {
+    kind: 'orphaned';
+    reason: 'noCandidates' | 'belowAccept' | 'ambiguous';
+};
+export declare function decide<T>(scored: Array<{
+    ref: T;
+    score: ScoreResult;
+}>, opts?: Partial<Thresholds>): Decision<T>;
+//# sourceMappingURL=decide.d.ts.map

package/dist/anchor/decide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../src/anchor/decide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAE/D,MAAM,MAAM,QAAQ,CAAC,CAAC,IAClB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACnD;IACE,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,CAAA;CACrD,CAAA;AAEL,wBAAgB,MAAM,CAAC,CAAC,EACtB,MAAM,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC,EAC7C,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GACzB,QAAQ,CAAC,CAAC,CAAC,CAcb"}

package/dist/anchor/index.d.ts

@@ -0,0 +1,9 @@
+export type { Decision } from './decide';
+export { decide } from './decide';
+export type { QuoteContext, QuoteOffsets } from './locate-quote';
+export { locateQuote } from './locate-quote';
+export type { ScoreComponents, ScoreResult } from './score';
+export { scoreCandidate } from './score';
+export type { Thresholds, WeightKey } from './weights';
+export { DEFAULT_THRESHOLDS, DEFAULT_WEIGHTS } from './weights';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/anchor/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA"}

package/dist/anchor/locate-quote.d.ts

@@ -0,0 +1,11 @@
+export type QuoteContext = {
+    quote: string;
+    prefix: string;
+    suffix: string;
+};
+export type QuoteOffsets = {
+    start: number;
+    end: number;
+};
+export declare function locateQuote(haystack: string, ctx: QuoteContext): QuoteOffsets | null;
+//# sourceMappingURL=locate-quote.d.ts.map

package/dist/anchor/locate-quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate-quote.d.ts","sourceRoot":"","sources":["../../src/anchor/locate-quote.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAC5E,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AA0DzD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI,CA0CpF"}

package/dist/anchor/score.d.ts

@@ -0,0 +1,10 @@
+import type { Signals } from '../schemas/anchor';
+import { type WeightKey } from './weights';
+export type ScoreComponents = Record<WeightKey, number>;
+export type ScoreResult = {
+    total: number;
+    components: ScoreComponents;
+    excluded: false | 'tagMismatch';
+};
+export declare function scoreCandidate(stored: Signals, candidate: Signals): ScoreResult;
+//# sourceMappingURL=score.d.ts.map

package/dist/anchor/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../src/anchor/score.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,WAAW,CAAA;AAE3D,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;AAEvD,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,eAAe,CAAA;IAC3B,QAAQ,EAAE,KAAK,GAAG,aAAa,CAAA;CAChC,CAAA;AAWD,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,WAAW,CAoB/E"}

package/dist/anchor/weights.d.ts

@@ -0,0 +1,18 @@
+export declare const DEFAULT_WEIGHTS: {
+    readonly stableAttrs: 0.4;
+    readonly text: 0.25;
+    readonly classes: 0.15;
+    readonly role: 0.1;
+    readonly sibling: 0.05;
+    readonly ancestor: 0.05;
+};
+export type WeightKey = keyof typeof DEFAULT_WEIGHTS;
+export declare const DEFAULT_THRESHOLDS: {
+    readonly accept: 0.6;
+    readonly margin: 0.1;
+};
+export type Thresholds = {
+    accept: number;
+    margin: number;
+};
+//# sourceMappingURL=weights.d.ts.map

package/dist/anchor/weights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weights.d.ts","sourceRoot":"","sources":["../../src/anchor/weights.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,eAAe,CAAA;AAEpD,eAAO,MAAM,kBAAkB;;;CAGrB,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/dist/contract/errors.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export declare const ERROR_CODES: readonly ["VALIDATION_FAILED", "AUTH_INVALID_KEY", "ORIGIN_NOT_ALLOWED", "NOT_FOUND", "CONFLICT", "UPLOAD_TOO_LARGE", "RATE_LIMITED", "INTERNAL"];
+export declare const ErrorCode: z.ZodEnum<{
+    VALIDATION_FAILED: "VALIDATION_FAILED";
+    AUTH_INVALID_KEY: "AUTH_INVALID_KEY";
+    ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED";
+    NOT_FOUND: "NOT_FOUND";
+    CONFLICT: "CONFLICT";
+    UPLOAD_TOO_LARGE: "UPLOAD_TOO_LARGE";
+    RATE_LIMITED: "RATE_LIMITED";
+    INTERNAL: "INTERNAL";
+}>;
+export type ErrorCode = z.infer<typeof ErrorCode>;
+export declare const ErrorResponse: z.ZodObject<{
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            VALIDATION_FAILED: "VALIDATION_FAILED";
+            AUTH_INVALID_KEY: "AUTH_INVALID_KEY";
+            ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED";
+            NOT_FOUND: "NOT_FOUND";
+            CONFLICT: "CONFLICT";
+            UPLOAD_TOO_LARGE: "UPLOAD_TOO_LARGE";
+            RATE_LIMITED: "RATE_LIMITED";
+            INTERNAL: "INTERNAL";
+        }>;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ErrorResponse = z.infer<typeof ErrorResponse>;
+export declare const ERROR_STATUS: Record<ErrorCode, number>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/contract/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/contract/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,WAAW,mJASd,CAAA;AAEV,eAAO,MAAM,SAAS;;;;;;;;;EAAsB,CAAA;AAC5C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA;AAEjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;iBAQM,CAAA;AAChC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CASlD,CAAA"}

package/dist/contract/openapi.d.ts

@@ -0,0 +1,3 @@
+import { createDocument } from 'zod-openapi';
+export declare function buildOpenApiDocument(): ReturnType<typeof createDocument>;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/contract/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/contract/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAIf,MAAM,aAAa,CAAA;AAUpB,wBAAgB,oBAAoB,IAAI,UAAU,CAAC,OAAO,cAAc,CAAC,CAkDxE"}

package/dist/contract/operations.d.ts

@@ -0,0 +1,18 @@
+import type { z } from 'zod';
+import type { ErrorCode } from './errors';
+export interface Operation {
+    operationId: string;
+    method: 'GET' | 'POST' | 'PATCH';
+    path: string;
+    summary: string;
+    params?: z.ZodObject;
+    query?: z.ZodObject;
+    body?: z.ZodType | 'multipart';
+    success: {
+        status: number;
+        schema: z.ZodType;
+    };
+    errors: ErrorCode[];
+}
+export declare const operations: Operation[];
+//# sourceMappingURL=operations.d.ts.map

package/dist/contract/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/contract/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAG5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAWzC,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAA;IACpB,KAAK,CAAC,EAAE,CAAC,CAAC,SAAS,CAAA;IACnB,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,WAAW,CAAA;IAC9B,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAA;KAAE,CAAA;IAC9C,MAAM,EAAE,SAAS,EAAE,CAAA;CACpB;AAID,eAAO,MAAM,UAAU,EAAE,SAAS,EAmEjC,CAAA"}

package/dist/contract/requests.d.ts

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+export declare const CreateThreadBody: z.ZodObject<{
+    pageKey: z.ZodOptional<z.ZodString>;
+    pageUrl: z.ZodURL;
+    pageTitle: z.ZodOptional<z.ZodString>;
+    anchor: z.ZodObject<{
+        schemaVersion: z.ZodNumber;
+        selectors: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+        signals: z.ZodObject<{
+            tag: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            textSnippet: z.ZodOptional<z.ZodString>;
+            classes: z.ZodArray<z.ZodString>;
+            siblingIndex: z.ZodNumber;
+            ancestorTrail: z.ZodArray<z.ZodString>;
+            stableAttrs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strip>;
+        offset: z.ZodObject<{
+            fx: z.ZodNumber;
+            fy: z.ZodNumber;
+        }, z.core.$strip>;
+        selection: z.ZodOptional<z.ZodObject<{
+            start: z.ZodObject<{
+                selectors: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+                textNodeIndex: z.ZodNumber;
+                offset: z.ZodNumber;
+            }, z.core.$strip>;
+            end: z.ZodObject<{
+                selectors: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+                textNodeIndex: z.ZodNumber;
+                offset: z.ZodNumber;
+            }, z.core.$strip>;
+            quote: z.ZodString;
+            prefix: z.ZodString;
+            suffix: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    comment: z.ZodObject<{
+        text: z.ZodString;
+        attachmentIds: z.ZodOptional<z.ZodArray<z.core.$ZodBranded<z.ZodString, "AttachmentId", "out">>>;
+    }, z.core.$strip>;
+    author: z.ZodObject<{
+        id: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "AuthorId", "out">>;
+        email: z.ZodEmail;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    captureContext: z.ZodObject<{
+        viewportW: z.ZodNumber;
+        viewportH: z.ZodNumber;
+        devicePixelRatio: z.ZodNumber;
+        userAgent: z.ZodString;
+    }, z.core.$strip>;
+    provenance: z.ZodOptional<z.ZodObject<{
+        commitSha: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        deploymentId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CreateThreadBody = z.infer<typeof CreateThreadBody>;
+export declare const ListThreadsQuery: z.ZodObject<{
+    pageKey: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        resolved: "resolved";
+    }>>;
+    sort: z.ZodOptional<z.ZodLiteral<"updatedAt">>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ListThreadsQuery = z.infer<typeof ListThreadsQuery>;
+export declare const ThreadIdParam: z.ZodObject<{
+    id: z.core.$ZodBranded<z.ZodString, "ThreadId", "out">;
+}, z.core.$strip>;
+export type ThreadIdParam = z.infer<typeof ThreadIdParam>;
+export declare const AddCommentBody: z.ZodObject<{
+    text: z.ZodString;
+    attachmentIds: z.ZodOptional<z.ZodArray<z.core.$ZodBranded<z.ZodString, "AttachmentId", "out">>>;
+    author: z.ZodObject<{
+        id: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "AuthorId", "out">>;
+        email: z.ZodEmail;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AddCommentBody = z.infer<typeof AddCommentBody>;
+export declare const SetThreadStatusBody: z.ZodObject<{
+    status: z.ZodEnum<{
+        open: "open";
+        resolved: "resolved";
+    }>;
+}, z.core.$strip>;
+export type SetThreadStatusBody = z.infer<typeof SetThreadStatusBody>;
+export declare const RefreshAnchorBody: z.ZodObject<{
+    selectors: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString], null>>;
+    signals: z.ZodOptional<z.ZodObject<{
+        tag: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        textSnippet: z.ZodOptional<z.ZodString>;
+        classes: z.ZodArray<z.ZodString>;
+        siblingIndex: z.ZodNumber;
+        ancestorTrail: z.ZodArray<z.ZodString>;
+        stableAttrs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    anchorState: z.ZodEnum<{
+        anchored: "anchored";
+        orphaned: "orphaned";
+    }>;
+    selectionLost: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RefreshAnchorBody = z.infer<typeof RefreshAnchorBody>;
+export declare const UploadForm: z.ZodObject<{
+    file: z.ZodString;
+}, z.core.$strip>;
+export type UploadForm = z.infer<typeof UploadForm>;
+//# sourceMappingURL=requests.d.ts.map

package/dist/contract/requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../src/contract/requests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAgBvB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAaM,CAAA;AACnC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D,eAAO,MAAM,gBAAgB;;;;;;;;iBAOM,CAAA;AACnC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D,eAAO,MAAM,aAAa;;iBAA6B,CAAA;AACvD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,eAAO,MAAM,cAAc;;;;;;;;iBAOM,CAAA;AACjC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D,eAAO,MAAM,mBAAmB;;;;;iBAEM,CAAA;AACtC,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAErE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;iBAOM,CAAA;AACpC,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAGjE,eAAO,MAAM,UAAU;;iBAIM,CAAA;AAC7B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA"}

package/dist/contract/responses.d.ts

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+export declare const ThreadListResponse: z.ZodObject<{
+    threads: z.ZodArray<z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "ThreadId", "out">;
+        scope: z.ZodLiteral<"page">;
+        pageKey: z.ZodNullable<z.ZodString>;
+        pageUrl: z.ZodURL;
+        pageTitle: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodObject<{
+            schemaVersion: z.ZodNumber;
+            selectors: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+            signals: z.ZodObject<{
+                tag: z.ZodString;
+                role: z.ZodOptional<z.ZodString>;
+                textSnippet: z.ZodOptional<z.ZodString>;
+                classes: z.ZodArray<z.ZodString>;
+                siblingIndex: z.ZodNumber;
+                ancestorTrail: z.ZodArray<z.ZodString>;
+                stableAttrs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>;
+            offset: z.ZodObject<{
+                fx: z.ZodNumber;
+                fy: z.ZodNumber;
+            }, z.core.$strip>;
+            selection: z.ZodOptional<z.ZodObject<{
+                start: z.ZodObject<{
+                    selectors: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+                    textNodeIndex: z.ZodNumber;
+                    offset: z.ZodNumber;
+                }, z.core.$strip>;
+                end: z.ZodObject<{
+                    selectors: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+                    textNodeIndex: z.ZodNumber;
+                    offset: z.ZodNumber;
+                }, z.core.$strip>;
+                quote: z.ZodString;
+                prefix: z.ZodString;
+                suffix: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        status: z.ZodEnum<{
+            open: "open";
+            resolved: "resolved";
+        }>;
+        anchorState: z.ZodEnum<{
+            anchored: "anchored";
+            orphaned: "orphaned";
+        }>;
+        selectionLost: z.ZodOptional<z.ZodBoolean>;
+        commentCount: z.ZodNumber;
+        unresolvedCount: z.ZodNumber;
+        createdBy: z.ZodObject<{
+            id: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "AuthorId", "out">>;
+            email: z.ZodEmail;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        lastActivityAt: z.ZodISODateTime;
+        schemaVersion: z.ZodNumber;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ThreadListResponse = z.infer<typeof ThreadListResponse>;
+//# sourceMappingURL=responses.d.ts.map

package/dist/contract/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/contract/responses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKM,CAAA;AACrC,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

package/dist/contract/wire.d.ts

@@ -0,0 +1,2 @@
+export declare const KEY_HEADER_NAME = "x-comments-key";
+//# sourceMappingURL=wire.d.ts.map

package/dist/contract/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/contract/wire.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,mBAAmB,CAAA"}

package/dist/ids.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export declare const ThreadId: z.core.$ZodBranded<z.ZodString, "ThreadId", "out">;
+export type ThreadId = z.infer<typeof ThreadId>;
+export declare const CommentId: z.core.$ZodBranded<z.ZodString, "CommentId", "out">;
+export type CommentId = z.infer<typeof CommentId>;
+export declare const AuthorId: z.core.$ZodBranded<z.ZodString, "AuthorId", "out">;
+export type AuthorId = z.infer<typeof AuthorId>;
+export declare const AttachmentId: z.core.$ZodBranded<z.ZodString, "AttachmentId", "out">;
+export type AttachmentId = z.infer<typeof AttachmentId>;
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,QAAQ,oDAAwC,CAAA;AAC7D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAA;AAE/C,eAAO,MAAM,SAAS,qDAAyC,CAAA;AAC/D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA;AAEjD,eAAO,MAAM,QAAQ,oDAAwC,CAAA;AAC7D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAA;AAE/C,eAAO,MAAM,YAAY,wDAA4C,CAAA;AACrE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from './anchor';
+export * from './contract/errors';
+export * from './contract/openapi';
+export * from './contract/operations';
+export * from './contract/requests';
+export * from './contract/responses';
+export * from './contract/wire';
+export * from './ids';
+export * from './pageKey';
+export * from './schemas/anchor';
+export * from './schemas/capture';
+export * from './schemas/comment';
+export * from './schemas/common';
+export * from './schemas/thread';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,OAAO,CAAA;AACrB,cAAc,WAAW,CAAA;AACzB,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA"}