@ahtmljs/schema 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @ahtmljs/schema — public API.
+ */
+export * from './types.js';
+export { SnapshotBuilder, snapshot, computeEtag } from './snapshot.js';
+export { validate, isValid, type Issue } from './validate.js';
+export { toJson, fromJson } from './format-json.js';
+export { toCompact, fromCompact } from './format-compact.js';
+export { diff, applyDiff } from './diff.js';
+//# 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;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @ahtmljs/schema — public API.
+ */
+export * from './types.js';
+export { SnapshotBuilder, snapshot, computeEtag } from './snapshot.js';
+export { validate, isValid } from './validate.js';
+export { toJson, fromJson } from './format-json.js';
+export { toCompact, fromCompact } from './format-compact.js';
+export { diff, applyDiff } from './diff.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAc,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/snapshot.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Snapshot builder DSL.
+ *
+ *   import { snapshot } from '@ahtmljs/schema';
+ *
+ *   const snap = snapshot(req.url, 'product_detail')
+ *     .ttl(300)
+ *     .policy({ agents_welcome: true, license: 'CC-BY-4.0' })
+ *     .add({
+ *       id: 'product:mbp-14-m3',
+ *       type: 'product',
+ *       name: 'MacBook Pro 14"',
+ *       price: { amount: 1999, currency: 'USD' },
+ *       stock: { status: 'in_stock', quantity: 42 },
+ *     })
+ *     .action({
+ *       id: 'purchase',
+ *       target: 'product:mbp-14-m3',
+ *       auth: 'required',
+ *       cost: { amount: 1999, currency: 'USD', category: 'purchase' },
+ *       reversible: { reversible: true, window: 'P30D', policy: 'full_refund' },
+ *       side_effects: ['charge_card', 'email_buyer', 'decrement_stock'],
+ *       confirmation: 'required',
+ *     })
+ *     .build();
+ */
+import type { Snapshot, PageType, Entity, Action, Policy, Provenance, Links, Meta, JsonSchema } from './types.js';
+export declare class SnapshotBuilder {
+    private snap;
+    constructor(url: string, pageType: PageType);
+    ttl(seconds: number): this;
+    etag(tag: string): this;
+    fetchedAt(iso: string): this;
+    policy(p: Policy): this;
+    provenance(p: Provenance): this;
+    add(...entities: Entity[]): this;
+    action(...actions: Action[]): this;
+    links(l: Links): this;
+    schema(name: string, def: JsonSchema): this;
+    meta(m: Meta): this;
+    build(): Snapshot;
+}
+export declare function snapshot(url: string, pageType: PageType): SnapshotBuilder;
+/**
+ * Compute a stable, weak ETag from snapshot content.
+ * Content-addressed: same entities + actions → same etag (regardless of fetched_at).
+ */
+export declare function computeEtag(s: Snapshot): string;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,MAAM,EACN,MAAM,EACN,UAAU,EACV,KAAK,EACL,IAAI,EACJ,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAW;gBAEX,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;IAW3C,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK1B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKvB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK5B,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvB,UAAU,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI;IAK/B,GAAG,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKhC,MAAM,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAKlC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI;IAKrB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI;IAM3C,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI;IAKnB,KAAK,IAAI,QAAQ;CAGlB;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,eAAe,CAEzE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAU/C"}

package/dist/snapshot.js

@@ -0,0 +1,109 @@
+/**
+ * Snapshot builder DSL.
+ *
+ *   import { snapshot } from '@ahtmljs/schema';
+ *
+ *   const snap = snapshot(req.url, 'product_detail')
+ *     .ttl(300)
+ *     .policy({ agents_welcome: true, license: 'CC-BY-4.0' })
+ *     .add({
+ *       id: 'product:mbp-14-m3',
+ *       type: 'product',
+ *       name: 'MacBook Pro 14"',
+ *       price: { amount: 1999, currency: 'USD' },
+ *       stock: { status: 'in_stock', quantity: 42 },
+ *     })
+ *     .action({
+ *       id: 'purchase',
+ *       target: 'product:mbp-14-m3',
+ *       auth: 'required',
+ *       cost: { amount: 1999, currency: 'USD', category: 'purchase' },
+ *       reversible: { reversible: true, window: 'P30D', policy: 'full_refund' },
+ *       side_effects: ['charge_card', 'email_buyer', 'decrement_stock'],
+ *       confirmation: 'required',
+ *     })
+ *     .build();
+ */
+import { AHTML_VERSION } from './types.js';
+export class SnapshotBuilder {
+    snap;
+    constructor(url, pageType) {
+        this.snap = {
+            ahtml: AHTML_VERSION,
+            url,
+            fetched_at: new Date().toISOString(),
+            page_type: pageType,
+            entities: [],
+            actions: [],
+        };
+    }
+    ttl(seconds) {
+        this.snap.ttl = seconds;
+        return this;
+    }
+    etag(tag) {
+        this.snap.etag = tag;
+        return this;
+    }
+    fetchedAt(iso) {
+        this.snap.fetched_at = iso;
+        return this;
+    }
+    policy(p) {
+        this.snap.policy = p;
+        return this;
+    }
+    provenance(p) {
+        this.snap.provenance = p;
+        return this;
+    }
+    add(...entities) {
+        this.snap.entities.push(...entities);
+        return this;
+    }
+    action(...actions) {
+        this.snap.actions.push(...actions);
+        return this;
+    }
+    links(l) {
+        this.snap.links = { ...this.snap.links, ...l };
+        return this;
+    }
+    schema(name, def) {
+        this.snap.schemas ??= {};
+        this.snap.schemas[name] = def;
+        return this;
+    }
+    meta(m) {
+        this.snap.meta = { ...this.snap.meta, ...m };
+        return this;
+    }
+    build() {
+        return structuredClone(this.snap);
+    }
+}
+export function snapshot(url, pageType) {
+    return new SnapshotBuilder(url, pageType);
+}
+/**
+ * Compute a stable, weak ETag from snapshot content.
+ * Content-addressed: same entities + actions → same etag (regardless of fetched_at).
+ */
+export function computeEtag(s) {
+    const stable = {
+        url: s.url,
+        page_type: s.page_type,
+        entities: s.entities,
+        actions: s.actions,
+        links: s.links,
+        policy: s.policy,
+    };
+    return `W/"${djb2(JSON.stringify(stable))}"`;
+}
+function djb2(str) {
+    let h = 5381;
+    for (let i = 0; i < str.length; i++)
+        h = ((h << 5) + h + str.charCodeAt(i)) | 0;
+    return (h >>> 0).toString(16);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,256 @@
+/**
+ * AHTML Semantic Snapshot — core type definitions.
+ *
+ * A snapshot is the canonical agent-facing representation of a web page.
+ * Same data, two serializations:
+ *   - JSON  (strict, machine-canonical)
+ *   - Compact text  (token-optimal for LLMs — see format-compact.ts)
+ */
+export type AhtmlVersion = '0.1';
+export interface Snapshot {
+    ahtml: AhtmlVersion;
+    url: string;
+    fetched_at: string;
+    ttl?: number;
+    etag?: string;
+    page_type: PageType;
+    policy?: Policy;
+    provenance?: Provenance;
+    entities: Entity[];
+    actions: Action[];
+    links?: Links;
+    schemas?: Record<string, JsonSchema>;
+    meta?: Meta;
+}
+export type PageType = 'home' | 'product_detail' | 'product_list' | 'article' | 'document' | 'profile' | 'task_list' | 'task_detail' | 'dataset' | 'conversation' | 'checkout' | 'search_results' | 'category' | 'other';
+export type EntityId = string;
+export type EntityType = 'product' | 'document' | 'task' | 'profile' | 'dataset' | 'conversation';
+export type Freshness = 'live' | 'near_realtime' | 'daily' | 'static';
+export interface BaseEntity {
+    id: EntityId;
+    type: EntityType;
+    freshness?: Freshness;
+    updated_at?: string;
+}
+export interface Money {
+    amount: number;
+    currency: string;
+}
+export interface Stock {
+    status: 'in_stock' | 'low_stock' | 'out_of_stock' | 'preorder' | 'discontinued';
+    quantity?: number;
+}
+export interface Asset {
+    url: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+}
+export interface Product extends BaseEntity {
+    type: 'product';
+    name: string;
+    brand?: string;
+    description?: string;
+    price?: Money;
+    list_price?: Money;
+    stock?: Stock;
+    sku?: string;
+    variants?: ProductVariant[];
+    images?: Asset[];
+    attributes?: Record<string, string | number | boolean>;
+    rating?: {
+        average: number;
+        count: number;
+    };
+    category?: EntityId;
+}
+export interface ProductVariant {
+    id: EntityId;
+    name: string;
+    price?: Money;
+    stock?: Stock;
+    attributes?: Record<string, string>;
+}
+export interface Document extends BaseEntity {
+    type: 'document';
+    title: string;
+    author?: string | string[];
+    published_at?: string;
+    modified_at?: string;
+    summary?: string;
+    content?: string;
+    word_count?: number;
+    reading_time?: number;
+    language?: string;
+    tags?: string[];
+    canonical_url?: string;
+}
+export interface Task extends BaseEntity {
+    type: 'task';
+    title: string;
+    description?: string;
+    state: 'open' | 'in_progress' | 'blocked' | 'done' | 'cancelled';
+    priority?: 'low' | 'medium' | 'high' | 'urgent';
+    assignee?: EntityId;
+    due_at?: string;
+    labels?: string[];
+    parent?: EntityId;
+}
+export interface Profile extends BaseEntity {
+    type: 'profile';
+    name: string;
+    kind: 'person' | 'organization' | 'bot';
+    handle?: string;
+    avatar?: Asset;
+    bio?: string;
+    email?: string;
+    homepage?: string;
+    verified?: boolean;
+    attributes?: Record<string, string>;
+}
+export interface DatasetColumn {
+    key: string;
+    label: string;
+    type: 'string' | 'number' | 'boolean' | 'datetime' | 'entity_ref' | 'money';
+    format?: string;
+}
+export interface Dataset extends BaseEntity {
+    type: 'dataset';
+    name: string;
+    columns: DatasetColumn[];
+    rows: unknown[][];
+    row_count_total?: number;
+    description?: string;
+}
+export interface ConversationMessage {
+    id: string;
+    author: EntityId;
+    posted_at: string;
+    content: string;
+    reply_to?: string;
+}
+export interface Conversation extends BaseEntity {
+    type: 'conversation';
+    title?: string;
+    participants: EntityId[];
+    messages: ConversationMessage[];
+    message_count_total?: number;
+}
+export type Entity = Product | Document | Task | Profile | Dataset | Conversation;
+export type ActionCategory = 'read' | 'search' | 'navigate' | 'create' | 'update' | 'delete' | 'transact' | 'send' | 'auth';
+export type AuthRequirement = 'none' | 'optional' | 'required' | {
+    scheme: string;
+    scopes?: string[];
+};
+export interface ActionCost {
+    amount?: number;
+    currency?: string;
+    unit?: 'request' | 'token' | 'credit' | 'message' | 'item';
+    category: 'free' | 'purchase' | 'subscription' | 'rate_limited' | 'compute';
+    notes?: string;
+}
+export interface Reversibility {
+    reversible: boolean;
+    window?: string;
+    policy?: string;
+}
+export type SideEffect = 'charge_card' | 'email_buyer' | 'email_seller' | 'sms' | 'decrement_stock' | 'create_account' | 'modify_profile' | 'public_post' | 'send_message' | 'consume_credit' | 'webhook' | string;
+export interface Action {
+    id: string;
+    label?: string;
+    target?: EntityId | EntityId[];
+    input?: JsonSchema | {
+        $ref: string;
+    };
+    output?: JsonSchema | {
+        $ref: string;
+    };
+    auth?: AuthRequirement;
+    cost?: ActionCost;
+    reversible?: Reversibility;
+    side_effects?: SideEffect[];
+    rate_limit?: string;
+    preview_url?: string;
+    execute_url?: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    confirmation?: 'none' | 'recommended' | 'required';
+    category?: ActionCategory;
+}
+export interface Policy {
+    agents_welcome: boolean;
+    license?: string;
+    rate_limit?: string;
+    actions_require?: string;
+    contact?: string;
+    terms_url?: string;
+    attribution_required?: boolean;
+    republish?: 'allowed' | 'denied' | 'attribution_only';
+    caching?: {
+        ttl?: number;
+        allowed?: boolean;
+    };
+}
+export interface Provenance {
+    issuer?: string;
+    signed?: boolean;
+    signature?: string;
+    signature_alg?: string;
+    fetched_via?: string;
+}
+export interface PaginationLink {
+    cursor?: string;
+    url?: string;
+    expected?: number;
+    total?: number;
+}
+export interface Links {
+    self?: string;
+    next?: PaginationLink;
+    prev?: PaginationLink;
+    parent?: EntityId | string;
+    related?: EntityId[];
+    canonical?: string;
+}
+export interface Meta {
+    snapshot_bytes?: number;
+    html_bytes?: number;
+    compression_ratio?: number;
+    generated_by?: string;
+    [k: string]: unknown;
+}
+export interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    required?: string[];
+    enum?: unknown[];
+    format?: string;
+    $ref?: string;
+    [k: string]: unknown;
+}
+export type DiffChange = {
+    op: 'add';
+    entity: Entity;
+} | {
+    op: 'remove';
+    id: EntityId;
+} | {
+    op: 'update';
+    id: EntityId;
+    patch: Record<string, unknown>;
+} | {
+    op: 'add_action';
+    action: Action;
+} | {
+    op: 'remove_action';
+    id: string;
+};
+export interface SnapshotDiff {
+    ahtml: AhtmlVersion;
+    url: string;
+    from_etag?: string;
+    to_etag?: string;
+    changes: DiffChange[];
+}
+export declare const AHTML_VERSION: AhtmlVersion;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * AHTML Semantic Snapshot — core type definitions.
+ *
+ * A snapshot is the canonical agent-facing representation of a web page.
+ * Same data, two serializations:
+ *   - JSON  (strict, machine-canonical)
+ *   - Compact text  (token-optimal for LLMs — see format-compact.ts)
+ */
+export const AHTML_VERSION = '0.1';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+SH,MAAM,CAAC,MAAM,aAAa,GAAiB,KAAK,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Zero-dependency structural validator for AHTML snapshots.
+ *
+ * Returns a list of human-readable issues. Empty array = valid.
+ * For full JSON Schema validation, run schema.json through any standard
+ * JSON Schema validator (ajv, etc.). This validator is intentionally lean
+ * so the @ahtmljs/schema package has zero runtime dependencies.
+ */
+import type { Snapshot } from './types.js';
+export interface Issue {
+    path: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+export declare function validate(snap: unknown): Issue[];
+export declare function isValid(snap: unknown): snap is Snapshot;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,YAAY,CAAC;AAE3D,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AA4BD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,EAAE,CAkE/C;AA+ED,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,QAAQ,CAEvD"}