@hark-protocol/protocol 0.1.0

package/dist/schemas/opportunity.d.ts

@@ -0,0 +1,177 @@
+import { z } from "zod";
+/**
+ * Advertiser-visible anonymous opportunity object (CLAUDE.md section 9).
+ * MUST NOT contain subjectRef, internal intent DB id, or any PII.
+ */
+export declare const harkOpportunitySchema: z.ZodObject<{
+    id: z.ZodString;
+    publisher: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        domain: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        domain?: string | undefined;
+    }, {
+        id: string;
+        name: string;
+        domain?: string | undefined;
+    }>;
+    placement: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        format: z.ZodEnum<["card", "banner", "text"]>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        format: "card" | "banner" | "text";
+    }, {
+        id: string;
+        name: string;
+        format: "card" | "banner" | "text";
+    }>;
+    intent: z.ZodObject<{
+        topics: z.ZodArray<z.ZodObject<{
+            id: z.ZodEffects<z.ZodString, string, string>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            confidence?: number | undefined;
+        }, {
+            id: string;
+            confidence?: number | undefined;
+        }>, "many">;
+        semanticSummary: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        assurances: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            provider: z.ZodString;
+            level: z.ZodOptional<z.ZodString>;
+            issuedAt: z.ZodOptional<z.ZodString>;
+            expiresAt: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            provider: string;
+            level?: string | undefined;
+            issuedAt?: string | undefined;
+            expiresAt?: string | undefined;
+        }, {
+            type: string;
+            provider: string;
+            level?: string | undefined;
+            issuedAt?: string | undefined;
+            expiresAt?: string | undefined;
+        }>, "many">>;
+        expiresAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        expiresAt: string;
+        topics: {
+            id: string;
+            confidence?: number | undefined;
+        }[];
+        semanticSummary?: string | undefined;
+        assurances?: {
+            type: string;
+            provider: string;
+            level?: string | undefined;
+            issuedAt?: string | undefined;
+            expiresAt?: string | undefined;
+        }[] | undefined;
+    }, {
+        expiresAt: string;
+        topics: {
+            id: string;
+            confidence?: number | undefined;
+        }[];
+        semanticSummary?: string | undefined;
+        assurances?: {
+            type: string;
+            provider: string;
+            level?: string | undefined;
+            issuedAt?: string | undefined;
+            expiresAt?: string | undefined;
+        }[] | undefined;
+    }>;
+    pricing: z.ZodObject<{
+        network: z.ZodLiteral<"hedera:testnet">;
+        asset: z.ZodLiteral<"0.0.0">;
+        amountTinybar: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        network: "hedera:testnet";
+        asset: "0.0.0";
+        amountTinybar: string;
+    }, {
+        network: "hedera:testnet";
+        asset: "0.0.0";
+        amountTinybar: string;
+    }>;
+    expiresAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    expiresAt: string;
+    id: string;
+    publisher: {
+        id: string;
+        name: string;
+        domain?: string | undefined;
+    };
+    placement: {
+        id: string;
+        name: string;
+        format: "card" | "banner" | "text";
+    };
+    intent: {
+        expiresAt: string;
+        topics: {
+            id: string;
+            confidence?: number | undefined;
+        }[];
+        semanticSummary?: string | undefined;
+        assurances?: {
+            type: string;
+            provider: string;
+            level?: string | undefined;
+            issuedAt?: string | undefined;
+            expiresAt?: string | undefined;
+        }[] | undefined;
+    };
+    pricing: {
+        network: "hedera:testnet";
+        asset: "0.0.0";
+        amountTinybar: string;
+    };
+}, {
+    expiresAt: string;
+    id: string;
+    publisher: {
+        id: string;
+        name: string;
+        domain?: string | undefined;
+    };
+    placement: {
+        id: string;
+        name: string;
+        format: "card" | "banner" | "text";
+    };
+    intent: {
+        expiresAt: string;
+        topics: {
+            id: string;
+            confidence?: number | undefined;
+        }[];
+        semanticSummary?: string | undefined;
+        assurances?: {
+            type: string;
+            provider: string;
+            level?: string | undefined;
+            issuedAt?: string | undefined;
+            expiresAt?: string | undefined;
+        }[] | undefined;
+    };
+    pricing: {
+        network: "hedera:testnet";
+        asset: "0.0.0";
+        amountTinybar: string;
+    };
+}>;
+export type HarkOpportunity = z.infer<typeof harkOpportunitySchema>;
+//# sourceMappingURL=opportunity.d.ts.map

package/dist/schemas/opportunity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.d.ts","sourceRoot":"","sources":["../../src/schemas/opportunity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schemas/opportunity.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { assuranceSchema } from "./assurance.js";
+import { intentTopicSchema, semanticSummarySchema } from "./intent.js";
+import { placementFormatSchema } from "./publisher.js";
+import { tinybarAmountSchema } from "./campaign.js";
+import { HEDERA_TESTNET_NETWORK, HBAR_ASSET_ID } from "../constants.js";
+/**
+ * Advertiser-visible anonymous opportunity object (CLAUDE.md section 9).
+ * MUST NOT contain subjectRef, internal intent DB id, or any PII.
+ */
+export const harkOpportunitySchema = z.object({
+    id: z.string(),
+    publisher: z.object({
+        id: z.string(),
+        name: z.string(),
+        domain: z.string().optional(),
+    }),
+    placement: z.object({
+        id: z.string(),
+        name: z.string(),
+        format: placementFormatSchema,
+    }),
+    intent: z.object({
+        topics: z.array(intentTopicSchema),
+        semanticSummary: semanticSummarySchema.optional(),
+        assurances: z.array(assuranceSchema).optional(),
+        expiresAt: z.string().datetime(),
+    }),
+    pricing: z.object({
+        network: z.literal(HEDERA_TESTNET_NETWORK),
+        asset: z.literal(HBAR_ASSET_ID),
+        amountTinybar: tinybarAmountSchema,
+    }),
+    expiresAt: z.string().datetime(),
+});
+//# sourceMappingURL=opportunity.js.map

package/dist/schemas/opportunity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.js","sourceRoot":"","sources":["../../src/schemas/opportunity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9B,CAAC;IACF,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,qBAAqB;KAC9B,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAClC,eAAe,EAAE,qBAAqB,CAAC,QAAQ,EAAE;QACjD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;QAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC;QAC1C,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;QAC/B,aAAa,EAAE,mBAAmB;KACnC,CAAC;IACF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

package/dist/schemas/publisher.d.ts

@@ -0,0 +1,56 @@
+import { z } from "zod";
+export declare const publisherSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    domain: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    active: z.ZodBoolean;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    slug: string;
+    name: string;
+    active: boolean;
+    createdAt: string;
+    domain?: string | undefined;
+    description?: string | undefined;
+}, {
+    id: string;
+    slug: string;
+    name: string;
+    active: boolean;
+    createdAt: string;
+    domain?: string | undefined;
+    description?: string | undefined;
+}>;
+export type Publisher = z.infer<typeof publisherSchema>;
+export declare const placementFormatSchema: z.ZodEnum<["card", "banner", "text"]>;
+export type PlacementFormat = z.infer<typeof placementFormatSchema>;
+export declare const placementSchema: z.ZodObject<{
+    id: z.ZodString;
+    publisherId: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    format: z.ZodEnum<["card", "banner", "text"]>;
+    description: z.ZodOptional<z.ZodString>;
+    active: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    slug: string;
+    name: string;
+    active: boolean;
+    publisherId: string;
+    format: "card" | "banner" | "text";
+    description?: string | undefined;
+}, {
+    id: string;
+    slug: string;
+    name: string;
+    active: boolean;
+    publisherId: string;
+    format: "card" | "banner" | "text";
+    description?: string | undefined;
+}>;
+export type Placement = z.infer<typeof placementSchema>;
+//# sourceMappingURL=publisher.d.ts.map

package/dist/schemas/publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.d.ts","sourceRoot":"","sources":["../../src/schemas/publisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;EAQ1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,qBAAqB,uCAAqC,CAAC;AACxE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;EAQ1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/schemas/publisher.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export const publisherSchema = z.object({
+    id: z.string(),
+    slug: z.string(),
+    name: z.string(),
+    domain: z.string().optional(),
+    description: z.string().optional(),
+    active: z.boolean(),
+    createdAt: z.string().datetime(),
+});
+export const placementFormatSchema = z.enum(["card", "banner", "text"]);
+export const placementSchema = z.object({
+    id: z.string(),
+    publisherId: z.string(),
+    slug: z.string(),
+    name: z.string(),
+    format: placementFormatSchema,
+    description: z.string().optional(),
+    active: z.boolean(),
+});
+//# sourceMappingURL=publisher.js.map

package/dist/schemas/publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.js","sourceRoot":"","sources":["../../src/schemas/publisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAGxE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,qBAAqB;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;CACpB,CAAC,CAAC"}

package/dist/schemas/reach.d.ts

@@ -0,0 +1,100 @@
+import { z } from "zod";
+/**
+ * POST /v1/reach request body (CLAUDE.md section 12).
+ */
+export declare const reachInputSchema: z.ZodObject<{
+    opportunityId: z.ZodString;
+    campaignId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    campaignId: string;
+    opportunityId: string;
+}, {
+    campaignId: string;
+    opportunityId: string;
+}>;
+export type ReachInput = z.infer<typeof reachInputSchema>;
+/**
+ * Advertiser-safe confirmation returned from POST /v1/reach.
+ * MUST NOT contain subjectRef, the internal intent id, or any PII.
+ */
+export declare const reachConfirmationSchema: z.ZodObject<{
+    deliveryId: z.ZodString;
+    status: z.ZodEnum<["queued", "served", "dismissed"]>;
+    publisher: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+    }, {
+        id: string;
+        name: string;
+    }>;
+    placement: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+    }, {
+        id: string;
+        name: string;
+    }>;
+    payment: z.ZodObject<{
+        network: z.ZodLiteral<"hedera:testnet">;
+        asset: z.ZodLiteral<"0.0.0">;
+        amountTinybar: z.ZodString;
+        transactionId: z.ZodOptional<z.ZodString>;
+        payerAccountId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        network: "hedera:testnet";
+        asset: "0.0.0";
+        amountTinybar: string;
+        transactionId?: string | undefined;
+        payerAccountId?: string | undefined;
+    }, {
+        network: "hedera:testnet";
+        asset: "0.0.0";
+        amountTinybar: string;
+        transactionId?: string | undefined;
+        payerAccountId?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    status: "queued" | "served" | "dismissed";
+    publisher: {
+        id: string;
+        name: string;
+    };
+    placement: {
+        id: string;
+        name: string;
+    };
+    payment: {
+        network: "hedera:testnet";
+        asset: "0.0.0";
+        amountTinybar: string;
+        transactionId?: string | undefined;
+        payerAccountId?: string | undefined;
+    };
+    deliveryId: string;
+}, {
+    status: "queued" | "served" | "dismissed";
+    publisher: {
+        id: string;
+        name: string;
+    };
+    placement: {
+        id: string;
+        name: string;
+    };
+    payment: {
+        network: "hedera:testnet";
+        asset: "0.0.0";
+        amountTinybar: string;
+        transactionId?: string | undefined;
+        payerAccountId?: string | undefined;
+    };
+    deliveryId: string;
+}>;
+export type ReachConfirmation = z.infer<typeof reachConfirmationSchema>;
+//# sourceMappingURL=reach.d.ts.map

package/dist/schemas/reach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reach.d.ts","sourceRoot":"","sources":["../../src/schemas/reach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/schemas/reach.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { deliveryPaymentSchema, deliveryStatusSchema } from "./delivery.js";
+/**
+ * POST /v1/reach request body (CLAUDE.md section 12).
+ */
+export const reachInputSchema = z.object({
+    opportunityId: z.string().min(1),
+    campaignId: z.string().min(1),
+});
+/**
+ * Advertiser-safe confirmation returned from POST /v1/reach.
+ * MUST NOT contain subjectRef, the internal intent id, or any PII.
+ */
+export const reachConfirmationSchema = z.object({
+    deliveryId: z.string(),
+    status: deliveryStatusSchema,
+    publisher: z.object({
+        id: z.string(),
+        name: z.string(),
+    }),
+    placement: z.object({
+        id: z.string(),
+        name: z.string(),
+    }),
+    payment: deliveryPaymentSchema,
+});
+//# sourceMappingURL=reach.js.map

package/dist/schemas/reach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reach.js","sourceRoot":"","sources":["../../src/schemas/reach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE5E;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC;AAGH;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,MAAM,EAAE,oBAAoB;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;IACF,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;IACF,OAAO,EAAE,qBAAqB;CAC/B,CAAC,CAAC"}

package/dist/taxonomy.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Canonical Hark topic taxonomy (CLAUDE.md section 8).
+ * Represented as code for v0.1 - no on-chain topic registry.
+ */
+export type TopicDefinition = {
+    id: string;
+    label: string;
+    parentId?: string;
+};
+export declare const TAXONOMY: ReadonlyMap<string, TopicDefinition>;
+export declare function getTopic(id: string): TopicDefinition | undefined;
+export declare function isValidTopicId(id: string): boolean;
+export declare function listTopics(): TopicDefinition[];
+/** True if `candidate` is the same topic as `target`, or a descendant of it. */
+export declare function isSameOrDescendant(candidate: string, target: string): boolean;
+/**
+ * Distance between two topics in the taxonomy tree, measured via their nearest
+ * common ancestor. Returns `Infinity` if the topics share no ancestor (including
+ * when either topic id is unknown).
+ */
+export declare function topicDistance(a: string, b: string): number;
+//# sourceMappingURL=taxonomy.d.ts.map

package/dist/taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.d.ts","sourceRoot":"","sources":["../src/taxonomy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA4CF,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAEzD,CAAC;AAEF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEhE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,UAAU,IAAI,eAAe,EAAE,CAE9C;AAaD,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB1D"}

package/dist/taxonomy.js

@@ -0,0 +1,81 @@
+const rawTopics = [
+    { id: "electronics", label: "Electronics" },
+    { id: "electronics.computer", label: "Computers", parentId: "electronics" },
+    { id: "electronics.computer.laptop", label: "Laptops", parentId: "electronics.computer" },
+    { id: "electronics.computer.desktop", label: "Desktops", parentId: "electronics.computer" },
+    { id: "electronics.phone", label: "Phones", parentId: "electronics" },
+    { id: "electronics.tablet", label: "Tablets", parentId: "electronics" },
+    { id: "travel", label: "Travel" },
+    { id: "travel.flight", label: "Flights", parentId: "travel" },
+    { id: "travel.hotel", label: "Hotels", parentId: "travel" },
+    { id: "travel.package", label: "Travel Packages", parentId: "travel" },
+    { id: "automotive", label: "Automotive" },
+    { id: "automotive.car", label: "Cars", parentId: "automotive" },
+    { id: "automotive.motorcycle", label: "Motorcycles", parentId: "automotive" },
+    { id: "finance", label: "Finance" },
+    { id: "finance.insurance", label: "Insurance", parentId: "finance" },
+    { id: "finance.credit-card", label: "Credit Cards", parentId: "finance" },
+    { id: "finance.loan", label: "Loans", parentId: "finance" },
+    { id: "sports", label: "Sports" },
+    { id: "sports.running", label: "Running", parentId: "sports" },
+    { id: "sports.cycling", label: "Cycling", parentId: "sports" },
+    { id: "fitness", label: "Fitness" },
+    { id: "fitness.gym", label: "Gym", parentId: "fitness" },
+    { id: "home", label: "Home" },
+    { id: "home.furniture", label: "Furniture", parentId: "home" },
+    { id: "home.renovation", label: "Renovation", parentId: "home" },
+    { id: "education", label: "Education" },
+    { id: "education.course", label: "Courses", parentId: "education" },
+    {
+        id: "education.student-technology",
+        label: "Student Technology",
+        parentId: "education",
+    },
+];
+export const TAXONOMY = new Map(rawTopics.map((topic) => [topic.id, topic]));
+export function getTopic(id) {
+    return TAXONOMY.get(id);
+}
+export function isValidTopicId(id) {
+    return TAXONOMY.has(id);
+}
+export function listTopics() {
+    return [...TAXONOMY.values()];
+}
+/** Full ancestor chain for a topic, from itself up to the root, e.g. ["a.b.c", "a.b", "a"]. */
+function ancestorChain(id) {
+    const chain = [];
+    let current = TAXONOMY.get(id);
+    while (current) {
+        chain.push(current.id);
+        current = current.parentId ? TAXONOMY.get(current.parentId) : undefined;
+    }
+    return chain;
+}
+/** True if `candidate` is the same topic as `target`, or a descendant of it. */
+export function isSameOrDescendant(candidate, target) {
+    return ancestorChain(candidate).includes(target);
+}
+/**
+ * Distance between two topics in the taxonomy tree, measured via their nearest
+ * common ancestor. Returns `Infinity` if the topics share no ancestor (including
+ * when either topic id is unknown).
+ */
+export function topicDistance(a, b) {
+    if (a === b)
+        return 0;
+    const chainA = ancestorChain(a);
+    const chainB = ancestorChain(b);
+    if (chainA.length === 0 || chainB.length === 0)
+        return Infinity;
+    const depthB = new Map(chainB.map((id, index) => [id, index]));
+    for (let indexA = 0; indexA < chainA.length; indexA += 1) {
+        const ancestor = chainA[indexA];
+        const indexB = depthB.get(ancestor);
+        if (indexB !== undefined) {
+            return indexA + indexB;
+        }
+    }
+    return Infinity;
+}
+//# sourceMappingURL=taxonomy.js.map

package/dist/taxonomy.js.map

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

package/dist/tinybar.d.ts

@@ -0,0 +1,4 @@
+/** Tinybar amounts are opaque decimal strings - compare/add via BigInt, never as floats. */
+export declare function tinybarLte(a: string, b: string): boolean;
+export declare function tinybarAdd(a: string, b: string): string;
+//# sourceMappingURL=tinybar.d.ts.map

package/dist/tinybar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tinybar.d.ts","sourceRoot":"","sources":["../src/tinybar.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/tinybar.js

@@ -0,0 +1,8 @@
+/** Tinybar amounts are opaque decimal strings - compare/add via BigInt, never as floats. */
+export function tinybarLte(a, b) {
+    return BigInt(a) <= BigInt(b);
+}
+export function tinybarAdd(a, b) {
+    return (BigInt(a) + BigInt(b)).toString();
+}
+//# sourceMappingURL=tinybar.js.map

package/dist/tinybar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tinybar.js","sourceRoot":"","sources":["../src/tinybar.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS;IAC7C,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS;IAC7C,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC5C,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@hark-protocol/protocol",
+  "version": "0.1.0",
+  "description": "Shared Zod schemas, taxonomy, and constants for the Hark Protocol intent-advertising ecosystem.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SiddharthaMadhav/ETHOnline-2026.git",
+    "directory": "packages/protocol"
+  },
+  "keywords": ["hark-protocol", "hedera", "x402", "intent-advertising"],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./hcs14": {
+      "types": "./dist/hcs14.d.ts",
+      "default": "./dist/hcs14.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
+  }
+}