@peac/mappings-content-signals 0.11.2

package/dist/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Content Signal Types (DD-136, DD-137)
+ *
+ * Types for content use policy signal observation.
+ * Signals RECORD observations, never enforce (DD-95 rail neutrality).
+ */
+/**
+ * Signal source identifier (DD-137 precedence order).
+ *
+ * Note: Content-Signal header is reserved for a future version when a parser
+ * is implemented. Only sources with shipped parsers are included here.
+ */
+export type SignalSource = 'tdmrep-json' | 'content-usage-header' | 'robots-txt';
+/** Three-state signal decision (DD-136) */
+export type SignalDecision = 'allow' | 'deny' | 'unspecified';
+/**
+ * Canonical purpose token for content signals.
+ *
+ * Subset of PEAC CanonicalPurpose relevant to content use policy signals.
+ */
+export type ContentPurpose = 'ai-training' | 'ai-inference' | 'ai-search' | 'ai-generative' | 'tdm';
+/** Single content signal entry from a specific source */
+export interface ContentSignalEntry {
+    /** Purpose this signal applies to */
+    purpose: ContentPurpose;
+    /** Three-state decision */
+    decision: SignalDecision;
+    /** Which source produced this signal */
+    source: SignalSource;
+    /** Raw value from the source (for debugging) */
+    raw_value?: string;
+}
+/** SF value type classification per RFC 9651 */
+export type SfValueType = 'token' | 'string' | 'boolean' | 'inner-list' | 'byte-sequence';
+/** Single parsed Structured Fields Dictionary member (RFC 9651) */
+export interface SfDictionaryMember {
+    /** Member key (lowercase, as parsed) */
+    key: string;
+    /** Raw member string from the header (key=value with parameters) */
+    raw: string;
+    /** SF value type classification */
+    valueType: SfValueType;
+    /** Token value if valueType is 'token', null otherwise */
+    tokenValue: string | null;
+}
+/** Full parse result from Content-Usage header parsing */
+export interface ContentUsageParseResult {
+    /** Original raw header value */
+    raw: string;
+    /** All parsed SF Dictionary members (known and unknown) */
+    parsed: SfDictionaryMember[];
+    /** Mapped signal entries for recognized AIPREF vocabulary keys */
+    entries: ContentSignalEntry[];
+    /** Unrecognized dictionary members (forward-compatible pass-through) */
+    extensions: SfDictionaryMember[];
+}
+/** Aggregated content signal observation */
+export interface ContentSignalObservation {
+    /** When the signals were observed (ISO 8601) */
+    observed_at: string;
+    /** URI the signals apply to */
+    target_uri: string;
+    /** Resolved signals (one per purpose, highest-priority source wins) */
+    signals: ContentSignalEntry[];
+    /** Content digest for integrity binding */
+    digest?: {
+        alg: 'sha-256';
+        val: string;
+    };
+    /** Which sources were checked */
+    sources_checked: SignalSource[];
+}
+/** Pre-fetched robots.txt content */
+export interface RobotsTxtInput {
+    /** Raw text content of robots.txt */
+    content: string;
+}
+/** Pre-fetched tdmrep.json content */
+export interface TdmrepInput {
+    /** Raw JSON string of tdmrep.json */
+    content: string;
+}
+/** Pre-fetched Content-Usage header value */
+export interface ContentUsageInput {
+    /** Raw header value */
+    value: string;
+}
+/** Maximum input size for robots.txt (500 KB) */
+export declare const MAX_ROBOTS_TXT_SIZE = 512000;
+/** Maximum input size for tdmrep.json (64 KB) */
+export declare const MAX_TDMREP_SIZE = 65536;
+/** Maximum header value size (8 KB) */
+export declare const MAX_HEADER_SIZE = 8192;
+/**
+ * AI-relevant user-agent strings for robots.txt parsing.
+ *
+ * Maps user-agent tokens to the content purposes they represent.
+ */
+export declare const AI_USER_AGENTS: Record<string, ContentPurpose[]>;
+/**
+ * Signal source precedence (DD-137).
+ * Lower index = higher priority.
+ *
+ * Note: Content-Signal header is reserved for a future version.
+ * When implemented, it will slot between tdmrep-json and content-usage-header.
+ */
+export declare const SOURCE_PRECEDENCE: readonly SignalSource[];
+//# 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":"AAAA;;;;;GAKG;AAMH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,sBAAsB,GAAG,YAAY,CAAC;AAEjF,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,WAAW,GAAG,eAAe,GAAG,KAAK,CAAC;AAEpG,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,OAAO,EAAE,cAAc,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,wCAAwC;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,eAAe,CAAC;AAE1F,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,SAAS,EAAE,WAAW,CAAC;IACvB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,0DAA0D;AAC1D,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,kEAAkE;IAClE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,wEAAwE;IACxE,UAAU,EAAE,kBAAkB,EAAE,CAAC;CAClC;AAED,4CAA4C;AAC5C,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,2CAA2C;IAC3C,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,SAAS,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,iCAAiC;IACjC,eAAe,EAAE,YAAY,EAAE,CAAC;CACjC;AAMD,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,iDAAiD;AACjD,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,iDAAiD;AACjD,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,uCAAuC;AACvC,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAU3D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,YAAY,EAI3C,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@peac/mappings-content-signals",
+  "version": "0.11.2",
+  "description": "Content use policy signal parsing for PEAC (robots.txt, tdmrep.json, Content-Usage)",
+  "main": "dist/index.cjs",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/peacprotocol/peac.git",
+    "directory": "packages/mappings/content-signals"
+  },
+  "author": "jithinraj <7850727+jithinraj@users.noreply.github.com>",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/peacprotocol/peac/issues"
+  },
+  "homepage": "https://github.com/peacprotocol/peac#readme",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@peac/kernel": "0.11.2",
+    "@peac/schema": "0.11.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.11",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.0",
+    "tsup": "^8.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "pnpm run build:js && pnpm run build:types",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist",
+    "build:js": "tsup",
+    "build:types": "rm -f dist/.tsbuildinfo && tsc && rm -f dist/.tsbuildinfo"
+  }
+}