@happyvertical/smrt-ingestion 0.0.0-stage → 0.55.6

package/dist/sources/common.d.ts

@@ -0,0 +1,32 @@
+import type { ReceiptResult } from '../dto.js';
+import type { IngestionService, IntakePart, ReceiveInput } from '../server.js';
+/** Host configuration, reconstructed from authenticated session/account state. */
+export interface SourceBinding {
+    enabled: boolean;
+    service: Pick<IngestionService, 'receive'>;
+    sourceId: string;
+    sourceVersion: string;
+    capturedCeiling: ReceiveInput['capturedCeiling'];
+    retention: ReceiveInput['retention'];
+    limits: ReceiveInput['limits'];
+    allowedMediaTypes: readonly string[];
+}
+export type SourceResult = ReceiptResult | {
+    kind: 'rejected';
+    category: 'authentication' | 'unsupported_type' | 'unavailable_bytes';
+};
+export declare class SourceInputError extends Error {
+    readonly category: 'invalid' | 'limit' | 'unsupported_type' | 'unavailable_bytes';
+    constructor(category: 'invalid' | 'limit' | 'unsupported_type' | 'unavailable_bytes');
+}
+export declare function record(value: unknown): Record<string, unknown>;
+export declare function keys(value: Record<string, unknown>, allowed: string[]): void;
+export declare function text(value: unknown): string;
+export declare function timestamp(value: unknown): Date;
+/** Bound bytes before parsing or handing them to the receipt service. */
+export declare function boundedBytes(stream: ReadableStream<Uint8Array> | null, limit: number): Promise<Uint8Array>;
+/** Intake validates signatures; decoding/format correctness belongs to extraction. */
+export declare function validateMedia(bytes: Uint8Array, type: string, allowed: readonly string[]): void;
+export declare function deliver(binding: SourceBinding, deliveryKey: string, deliveredAt: Date, parts: IntakePart[]): Promise<SourceResult>;
+export declare function safeFailure(error: unknown): SourceResult;
+//# sourceMappingURL=common.d.ts.map

package/dist/sources/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/sources/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE/E,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACjD,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AACD,MAAM,MAAM,YAAY,GACpB,aAAa,GACb;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;CACvE,CAAC;AACN,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,QAAQ,EACpB,SAAS,GACT,OAAO,GACP,kBAAkB,GAClB,mBAAmB;gBAJP,QAAQ,EACpB,SAAS,GACT,OAAO,GACP,kBAAkB,GAClB,mBAAmB;CAI1B;AACD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9D;AACD,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAG5E;AACD,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI3C;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAI9C;AACD,yEAAyE;AACzE,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,EACzC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,CAAC,CAsBrB;AACD,sFAAsF;AACtF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,IAAI,CAmCN;AACD,wBAAsB,OAAO,CAC3B,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,IAAI,EACjB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,YAAY,CAAC,CA2BvB;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAIxD"}

package/dist/sources/email.d.ts

@@ -0,0 +1,40 @@
+import { type SourceBinding, type SourceResult } from './common.js';
+/** Structural messages-owner seam; EmailAccount.readIntakeMessage implements this contract. */
+export interface EmailIntakeSnapshot {
+    accountId: string;
+    messageId: string;
+    threadId: string;
+    inReplyTo: string;
+    subject: string;
+    text: string;
+    html: string;
+    date: string;
+    attachments: Array<{
+        partId: string;
+        filename: string;
+        mediaType: string;
+        bytes: Uint8Array;
+    }>;
+}
+export interface EmailDelivery {
+    /** Provider/account-unique locator (e.g. folder + UIDVALIDITY + UID), not sender Message-ID alone. */
+    locator: string;
+    /** Explicit immutable source revision, never an automatically substituted content hash. */
+    revision: string;
+    checkpoint: string;
+}
+export interface EmailSourceOptions {
+    binding: SourceBinding;
+    accountId: string;
+    readMessage(delivery: EmailDelivery): Promise<EmailIntakeSnapshot>;
+    /** Durable host checkpoint; called in input order only after accepted/duplicate. */
+    acknowledge(checkpoint: string): Promise<void>;
+}
+/** Opt-in intake: hosts enumerate configured accounts and supply resumable provider locators. */
+export declare class EmailSourceAdapter {
+    private readonly options;
+    constructor(options: EmailSourceOptions);
+    receive(delivery: EmailDelivery): Promise<SourceResult>;
+    receiveBatch(deliveries: readonly EmailDelivery[]): Promise<SourceResult[]>;
+}
+//# sourceMappingURL=email.d.ts.map

package/dist/sources/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/sources/email.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,YAAY,EAGlB,MAAM,aAAa,CAAC;AAErB,+FAA+F;AAC/F,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,UAAU,CAAC;KACnB,CAAC,CAAC;CACJ;AACD,MAAM,WAAW,aAAa;IAC5B,sGAAsG;IACtG,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnE,oFAAoF;IACpF,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AACD,iGAAiG;AACjG,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,kBAAkB;IAClD,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA+FvD,YAAY,CAChB,UAAU,EAAE,SAAS,aAAa,EAAE,GACnC,OAAO,CAAC,YAAY,EAAE,CAAC;CAS3B"}

package/dist/sources/http.d.ts

@@ -0,0 +1,30 @@
+import type { IntakePart } from '../server.js';
+import { type SourceBinding } from './common.js';
+export interface AuthenticatedSource extends SourceBinding {
+    /** Explicit wire limit includes multipart framing and capture metadata. */
+    maxRequestBytes: number;
+    /** Host proves ownership/current access and copies immutable owner bytes. */
+    snapshotReference?(reference: {
+        owner: 'asset' | 'message';
+        id: string;
+        version: string;
+    }): Promise<IntakePart[]>;
+}
+export interface SourceHttpOptions {
+    /** Authenticate and select enabled source from server configuration, never body fields. */
+    authenticate(request: Request): Promise<AuthenticatedSource | null>;
+}
+/** Reference Web Request handler; mobile clients reuse their durable UUID Idempotency-Key. */
+export declare function createSourceDeliveryHandler(options: SourceHttpOptions): (request: Request) => Promise<Response>;
+export interface VerifiedVendorDelivery {
+    binding: SourceBinding;
+    deliveryKey: string;
+    deliveredAt: Date;
+    parts: IntakePart[];
+}
+/** Vendor implementation owns signature/timestamp verification and replay identity. */
+export declare function createVendorWebhookHandler(options: {
+    maxRequestBytes: number;
+    verify(request: Request, originalBytes: Uint8Array): Promise<VerifiedVendorDelivery | null>;
+}): (request: Request) => Promise<Response>;
+//# sourceMappingURL=http.d.ts.map

package/dist/sources/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/sources/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAKL,KAAK,aAAa,EAMnB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,2EAA2E;IAC3E,eAAe,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,iBAAiB,CAAC,CAAC,SAAS,EAAE;QAC5B,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;QAC3B,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CAC3B;AACD,MAAM,WAAW,iBAAiB;IAChC,2FAA2F;IAC3F,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;CACrE;AAeD,8FAA8F;AAC9F,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,GACzB,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA6IzC;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,IAAI,CAAC;IAClB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AACD,uFAAuF;AACvF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CACJ,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,UAAU,GACxB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;CAC3C,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAoB1C"}

package/dist/sources/index.d.ts

@@ -0,0 +1,8 @@
+export type { SourceBinding, SourceResult } from './common.js';
+export type { EmailDelivery, EmailIntakeSnapshot, EmailSourceOptions, } from './email.js';
+export { EmailSourceAdapter } from './email.js';
+export type { AuthenticatedSource, SourceHttpOptions, VerifiedVendorDelivery, } from './http.js';
+export { createSourceDeliveryHandler, createVendorWebhookHandler, } from './http.js';
+export type { WatchFolderOptions, WatchFolderResult } from './watch-folder.js';
+export { WatchFolderSourceAdapter } from './watch-folder.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/sources/watch-folder.d.ts

@@ -0,0 +1,27 @@
+import { type SourceBinding, type SourceResult } from './common.js';
+export interface WatchFolderOptions {
+    binding: SourceBinding;
+    /** Private producer directory; claims and processed live on the same filesystem. */
+    directory: string;
+    stabilityMs: number;
+    now?: () => number;
+    /** Observability/crash injection. Never receives file content or credentials. */
+    checkpoint?(boundary: 'claimed' | 'received', claimId: string): Promise<void>;
+}
+export interface WatchFolderResult {
+    claimId?: string;
+    filename: string;
+    result: SourceResult;
+}
+/** Files remain in claims until the durable receipt succeeds. A restart safely replays them. */
+export declare class WatchFolderSourceAdapter {
+    private readonly options;
+    private readonly observations;
+    private polling;
+    constructor(options: WatchFolderOptions);
+    private stable;
+    private syncDirectory;
+    private importClaim;
+    poll(): Promise<WatchFolderResult[]>;
+}
+//# sourceMappingURL=watch-folder.d.ts.map

package/dist/sources/watch-folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-folder.d.ts","sourceRoot":"","sources":["../../src/sources/watch-folder.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,YAAY,EAElB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,aAAa,CAAC;IACvB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,iFAAiF;IACjF,UAAU,CAAC,CAAC,QAAQ,EAAE,SAAS,GAAG,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E;AACD,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAYD,gGAAgG;AAChG,qBAAa,wBAAwB;IAGvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,OAAO,CAAS;gBACK,OAAO,EAAE,kBAAkB;YAI1C,MAAM;YAmBN,aAAa;YAQb,WAAW;IAuFnB,IAAI,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;CA2F3C"}

package/package.json

@@ -1,6 +1,89 @@
 {
   "name": "@happyvertical/smrt-ingestion",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.55.6",
+  "description": "Durable tenant-scoped intake and evidence foundations",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "agents",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "EXTRACTION.md",
+    "PROPOSALS.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./dto": {
+      "types": "./dist/dto.d.ts",
+      "import": "./dist/dto.js"
+    },
+    "./models": {
+      "types": "./dist/models.d.ts",
+      "import": "./dist/models.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./manifest.json": "./dist/manifest.json",
+    "./execution": {
+      "types": "./dist/execution.d.ts",
+      "import": "./dist/execution.js"
+    },
+    "./proposals": {
+      "types": "./dist/proposals.d.ts",
+      "import": "./dist/proposals.js"
+    }
+  },
+  "dependencies": {
+    "@happyvertical/smrt-core": "0.55.6",
+    "@happyvertical/smrt-types": "0.55.6",
+    "@happyvertical/smrt-tenancy": "0.55.6",
+    "@happyvertical/smrt-assets": "0.55.6",
+    "@happyvertical/smrt-jobs": "0.55.6",
+    "@happyvertical/sql": "^0.102.4",
+    "@happyvertical/pdf": "^0.65.9",
+    "@happyvertical/ocr": "^0.61.6",
+    "@happyvertical/speech": "^0.102.4",
+    "@happyvertical/ai": "^0.102.4",
+    "sharp": "^0.35.5",
+    "@happyvertical/smrt-agents": "0.55.6",
+    "@happyvertical/smrt-playbooks": "0.55.6",
+    "ajv": "8.20.0"
+  },
+  "devDependencies": {
+    "@happyvertical/smrt-vitest": "0.55.6",
+    "@types/node": "24.13.6",
+    "typescript": "6.0.3",
+    "vite": "8.1.4",
+    "vitest": "4.1.10",
+    "@happyvertical/smrt-content": "0.55.6",
+    "@happyvertical/smrt-users": "0.55.6"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "author": "HappyVertical",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/ingestion"
+  },
+  "scripts": {
+    "build": "vite build --mode library && node scripts/check-browser.mjs",
+    "test": "vitest run",
+    "test:postgres": "node ../../scripts/run-with-ci-postgres.mjs -- pnpm exec vitest run --config vitest.postgres.config.ts",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+    "test:providers": "vitest run src/extraction.providers.test.ts src/proposals.providers.test.ts",
+    "test:components": "node scripts/unavailable-lane.mjs components",
+    "test:e2e": "node scripts/unavailable-lane.mjs e2e",
+    "test:evaluation": "node scripts/unavailable-lane.mjs evaluation"
+  }
 }