@phosphorco/bb-cross-references 0.1.1 → 0.3.0

package/dist/types/index.d.ts

@@ -532,3 +532,7 @@ export type GetProjectionRpcOutput = GetProjectionResponse;
 export type ListBacklinksRpcOutput = ListBacklinksResponse;
 export type ListForwardReferencesRpcOutput = ListForwardReferencesResponse;
 export type AttachmentSnapshot = ReferenceSnapshot;
+export { recognitionIdentity, recognitionIdentityRecord, RECOGNITION_CODEC_VERSION, MAX_RECOGNITION_IDENTITY_BYTES, type VerifiedRecognitionThread } from './recognition.js';
+export { verifiedFileIdentity, verifiedFileIdentityRecord, VerifiedFileTargetSchema, type VerifiedFileTarget } from './recognition.js';
+export * from './evidence-v2.js';
+export * from './lookup.js';

package/dist/types/lookup.d.ts

@@ -0,0 +1,10 @@
+import { type MentionQueryV2 } from './evidence-v2.js';
+export declare function githubLookup(value: string): {
+    query: MentionQueryV2;
+    source: {
+        provider: 'github';
+        id: string;
+        kind: 'pull-request' | 'issue';
+    };
+    label: string;
+} | null;

package/dist/types/recognition.d.ts

@@ -0,0 +1,29 @@
+/** Pure identity codec. Verification is supplied by the consumer, never inferred
+ * from recognition attribution. kind and authored location are not identity. */
+import { z } from 'zod';
+import { type SourceIdentity } from '@phosphorco/bb-context-recognition';
+import { type ResourceIdentity } from './canonical.js';
+export declare const RECOGNITION_CODEC_VERSION = 1;
+export declare const MAX_RECOGNITION_IDENTITY_BYTES = 16384;
+export type VerifiedRecognitionThread = {
+    id: string;
+    projectId: string;
+    deletedAt?: number | null;
+};
+export declare function recognitionIdentity(source: SourceIdentity, verified?: VerifiedRecognitionThread): ResourceIdentity;
+export declare function recognitionIdentityRecord(source: SourceIdentity): string;
+/** Verified installation-local file codec. Lexical paths are canonical slash
+ * segments; filesystem verification stays in the consumer. No Unicode/case or
+ * symlink alias rewriting: realpath establishes containment, never identity. */
+export declare const VerifiedFileTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"workspace">;
+    environmentId: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"thread-storage">;
+    threadId: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strict>], "kind">;
+export type VerifiedFileTarget = z.infer<typeof VerifiedFileTargetSchema>;
+export declare function verifiedFileIdentity(value: VerifiedFileTarget): ResourceIdentity;
+export declare function verifiedFileIdentityRecord(value: VerifiedFileTarget): string;

package/dist/types/testing.d.ts

@@ -12,3 +12,14 @@ export declare function runCrossReferencesConformance(options: {
     /** Use an isolated fixture source with a fresh revision and at least one target. */
     command: ApplyProjectionInput;
 }): Promise<CrossReferencesConformanceResult>;
+/** Read-only V2 conformance through the adopter's real transport/handlers.
+ * The caller owns fixture preparation; this kit never enqueues or writes. */
+export declare function runCrossReferencesV2Conformance(options: {
+    sdk: CrossReferencesSdk;
+    pluginId?: string;
+    input: import('./evidence-v2.js').ListMentionsInputV2;
+    lookup: import('./evidence-v2.js').ResolveLookupInputV2;
+    assertPage: (page: Extract<import('./evidence-v2.js').ListMentionsOutputV2, {
+        status: 'page';
+    }>) => void | Promise<void>;
+}): Promise<CrossReferencesConformanceResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phosphorco/bb-cross-references",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "type": "module",
   "license": "MIT",
   "description": "Shared Cross References v1 codecs, explicit clients, and reference controls.",
@@ -48,7 +48,8 @@
   },
   "dependencies": {
     "zod": "4.6.7",
-    "@noble/hashes": "1.8.0"
+    "@noble/hashes": "1.8.0",
+    "@phosphorco/bb-context-recognition": "0.5.0"
   },
   "peerDependencies": {
     "@get-bb/plugin-sdk": ">=0.5.29 <0.6 || ^0.6.29",
@@ -79,7 +80,7 @@
     "@types/jsdom": "21.1.7"
   },
   "scripts": {
-    "build": "bun tools/build.mjs --entry \"src/index.ts\" --target browser --entry \"src/bb.ts\" --target browser --entry \"src/react.tsx\" --target browser --entry \"src/testing.ts\" --target browser --external \"zod\" --external \"@noble/hashes/*\" --external \"react\" --external \"react/*\" --external \"react-dom\" --external \"react-dom/*\" --external \"@get-bb/plugin-sdk\" --external \"@get-bb/plugin-sdk/*\" && tsc --project tsconfig.declarations.json && cp src/references.css dist/references.css",
+    "build": "bun tools/build.mjs --entry \"src/index.ts\" --target browser --entry \"src/bb.ts\" --target browser --entry \"src/react.tsx\" --target browser --entry \"src/testing.ts\" --target browser --external \"zod\" --external \"@phosphorco/bb-context-recognition\" --external \"@noble/hashes/*\" --external \"react\" --external \"react/*\" --external \"react-dom\" --external \"react-dom/*\" --external \"@get-bb/plugin-sdk\" --external \"@get-bb/plugin-sdk/*\" && tsc --project tsconfig.declarations.json && cp src/references.css dist/references.css",
     "test": "bun test test",
     "typecheck": "tsc --noEmit"
   }