@sprinterai/runtime 0.7.1 → 0.9.0

package/dist/document/deletion.test.js

@@ -0,0 +1,33 @@
+import { describe, it, expect, vi } from 'vitest';
+import { deleteDocument } from './deletion.js';
+function makeStore() {
+    return {
+        deleteDocumentWithFile: vi.fn(async () => undefined),
+    };
+}
+describe('deleteDocument', () => {
+    it('delegates to store.deleteDocumentWithFile', async () => {
+        const store = makeStore();
+        await deleteDocument(store, 'doc-1');
+        expect(store.deleteDocumentWithFile).toHaveBeenCalledWith('doc-1');
+    });
+    it('calls with the exact documentId provided', async () => {
+        const store = makeStore();
+        await deleteDocument(store, 'doc-abc-123');
+        expect(store.deleteDocumentWithFile).toHaveBeenCalledWith('doc-abc-123');
+        expect(store.deleteDocumentWithFile).toHaveBeenCalledTimes(1);
+    });
+    it('propagates store errors', async () => {
+        const store = {
+            deleteDocumentWithFile: vi.fn(async () => {
+                throw new Error('File not found in storage');
+            }),
+        };
+        await expect(deleteDocument(store, 'doc-1')).rejects.toThrow('File not found in storage');
+    });
+    it('resolves without error on success', async () => {
+        const store = makeStore();
+        await expect(deleteDocument(store, 'doc-1')).resolves.toBeUndefined();
+    });
+});
+//# sourceMappingURL=deletion.test.js.map

package/dist/document/deletion.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deletion.test.js","sourceRoot":"","sources":["../../src/document/deletion.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,SAAS,SAAS;IAChB,OAAO;QACL,sBAAsB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAE1B,MAAM,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAErC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAE1B,MAAM,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAE3C,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;QACzE,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,KAAK,GAA0B;YACnC,sBAAsB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;gBACvC,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC/C,CAAC,CAAC;SACH,CAAC;QAEF,MAAM,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,MAAM,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/document/index.d.ts

@@ -2,4 +2,16 @@ export { chunkText, chunkPages } from './chunk-generator.js';
 export { createDocumentProcessor } from './document-processor.js';
 export type { ProcessDocumentOptions, ProcessDocumentResult } from './document-processor.js';
 export { textParser } from './parsers/index.js';
+export { uploadDocument } from './upload.js';
+export type { UploadDocumentStore } from './upload.js';
+export { getDocumentPages, getDocumentPage } from './pagination.js';
+export type { DocumentPageStore } from './pagination.js';
+export { searchDocumentPages, searchAllDocuments } from './search.js';
+export type { DocumentSearchStore } from './search.js';
+export { linkDocumentToEntity, unlinkDocumentFromEntity, DOCUMENT_RELATIONSHIP_TYPE, } from './linking.js';
+export type { DocumentLinkStore } from './linking.js';
+export { deleteDocument } from './deletion.js';
+export type { DocumentDeletionStore } from './deletion.js';
+export { getDocumentUrl, DEFAULT_URL_EXPIRY_SECONDS } from './url-generation.js';
+export type { DocumentUrlStore } from './url-generation.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/document/index.js

@@ -1,4 +1,11 @@
 export { chunkText, chunkPages } from './chunk-generator.js';
 export { createDocumentProcessor } from './document-processor.js';
 export { textParser } from './parsers/index.js';
+// ─── Document Operations ────────────────────────────────────
+export { uploadDocument } from './upload.js';
+export { getDocumentPages, getDocumentPage } from './pagination.js';
+export { searchDocumentPages, searchAllDocuments } from './search.js';
+export { linkDocumentToEntity, unlinkDocumentFromEntity, DOCUMENT_RELATIONSHIP_TYPE, } from './linking.js';
+export { deleteDocument } from './deletion.js';
+export { getDocumentUrl, DEFAULT_URL_EXPIRY_SECONDS } from './url-generation.js';
 //# sourceMappingURL=index.js.map

package/dist/document/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,+DAA+D;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnE,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/document/linking.d.ts

@@ -0,0 +1,42 @@
+import type { DocumentRecord } from '@sprinterai/core';
+/** Relationship type used when linking a document to an entity. */
+export declare const DOCUMENT_RELATIONSHIP_TYPE: "document";
+/** Minimal store surface required for document-entity linking. */
+export interface DocumentLinkStore {
+    /** Get a document record by ID. */
+    getDocument(id: string): Promise<DocumentRecord | null>;
+    /** Create a directional relation between two entities. */
+    createEntityRelation(input: {
+        tenantId: string;
+        fromEntityId: string;
+        toEntityId: string;
+        relationshipType: string;
+    }): Promise<void>;
+    /** Remove a directional relation between two entities. */
+    deleteEntityRelation(input: {
+        tenantId: string;
+        fromEntityId: string;
+        toEntityId: string;
+        relationshipType: string;
+    }): Promise<void>;
+}
+/**
+ * Link a document to an entity by creating an entity relation.
+ * The document must have an associated `document_entity_id`.
+ *
+ * @param store - Document + relation store.
+ * @param documentId - The document to link.
+ * @param entityId - The entity to link from.
+ * @param tenantId - The owning tenant.
+ */
+export declare function linkDocumentToEntity(store: DocumentLinkStore, documentId: string, entityId: string, tenantId: string): Promise<void>;
+/**
+ * Remove the link between a document and an entity.
+ *
+ * @param store - Document + relation store.
+ * @param documentId - The document to unlink.
+ * @param entityId - The entity to unlink from.
+ * @param tenantId - The owning tenant.
+ */
+export declare function unlinkDocumentFromEntity(store: DocumentLinkStore, documentId: string, entityId: string, tenantId: string): Promise<void>;
+//# sourceMappingURL=linking.d.ts.map

package/dist/document/linking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linking.d.ts","sourceRoot":"","sources":["../../src/document/linking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,mEAAmE;AACnE,eAAO,MAAM,0BAA0B,EAAG,UAAmB,CAAC;AAE9D,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACxD,0DAA0D;IAC1D,oBAAoB,CAAC,KAAK,EAAE;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,0DAA0D;IAC1D,oBAAoB,CAAC,KAAK,EAAE;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/document/linking.js

@@ -0,0 +1,49 @@
+/** Relationship type used when linking a document to an entity. */
+export const DOCUMENT_RELATIONSHIP_TYPE = 'document';
+/**
+ * Link a document to an entity by creating an entity relation.
+ * The document must have an associated `document_entity_id`.
+ *
+ * @param store - Document + relation store.
+ * @param documentId - The document to link.
+ * @param entityId - The entity to link from.
+ * @param tenantId - The owning tenant.
+ */
+export async function linkDocumentToEntity(store, documentId, entityId, tenantId) {
+    const doc = await store.getDocument(documentId);
+    if (!doc) {
+        throw new Error(`Document not found: ${documentId}`);
+    }
+    if (!doc.entity_id) {
+        throw new Error(`Document ${documentId} has no entity representation to link from`);
+    }
+    await store.createEntityRelation({
+        tenantId,
+        fromEntityId: entityId,
+        toEntityId: doc.entity_id,
+        relationshipType: DOCUMENT_RELATIONSHIP_TYPE,
+    });
+}
+/**
+ * Remove the link between a document and an entity.
+ *
+ * @param store - Document + relation store.
+ * @param documentId - The document to unlink.
+ * @param entityId - The entity to unlink from.
+ * @param tenantId - The owning tenant.
+ */
+export async function unlinkDocumentFromEntity(store, documentId, entityId, tenantId) {
+    const doc = await store.getDocument(documentId);
+    if (!doc) {
+        throw new Error(`Document not found: ${documentId}`);
+    }
+    if (!doc.entity_id)
+        return; // Nothing to unlink
+    await store.deleteEntityRelation({
+        tenantId,
+        fromEntityId: entityId,
+        toEntityId: doc.entity_id,
+        relationshipType: DOCUMENT_RELATIONSHIP_TYPE,
+    });
+}
+//# sourceMappingURL=linking.js.map

package/dist/document/linking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linking.js","sourceRoot":"","sources":["../../src/document/linking.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,MAAM,CAAC,MAAM,0BAA0B,GAAG,UAAmB,CAAC;AAsB9D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAwB,EACxB,UAAkB,EAClB,QAAgB,EAChB,QAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,YAAY,UAAU,4CAA4C,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,KAAK,CAAC,oBAAoB,CAAC;QAC/B,QAAQ;QACR,YAAY,EAAE,QAAQ;QACtB,UAAU,EAAE,GAAG,CAAC,SAAS;QACzB,gBAAgB,EAAE,0BAA0B;KAC7C,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAwB,EACxB,UAAkB,EAClB,QAAgB,EAChB,QAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,SAAS;QAAE,OAAO,CAAC,oBAAoB;IAEhD,MAAM,KAAK,CAAC,oBAAoB,CAAC;QAC/B,QAAQ;QACR,YAAY,EAAE,QAAQ;QACtB,UAAU,EAAE,GAAG,CAAC,SAAS;QACzB,gBAAgB,EAAE,0BAA0B;KAC7C,CAAC,CAAC;AACL,CAAC"}

package/dist/document/linking.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=linking.test.d.ts.map

package/dist/document/linking.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linking.test.d.ts","sourceRoot":"","sources":["../../src/document/linking.test.ts"],"names":[],"mappings":""}

package/dist/document/linking.test.js

@@ -0,0 +1,86 @@
+import { describe, it, expect, vi } from 'vitest';
+import { linkDocumentToEntity, unlinkDocumentFromEntity, DOCUMENT_RELATIONSHIP_TYPE, } from './linking.js';
+function makeDoc(overrides = {}) {
+    return {
+        id: 'doc-1',
+        tenant_id: 'tenant-1',
+        entity_id: 'doc-entity-1',
+        title: 'Report',
+        file_name: 'report.pdf',
+        file_type: 'application/pdf',
+        file_size: 2048,
+        storage_path: 'tenant-1/doc-1/report.pdf',
+        url: null,
+        status: 'ready',
+        page_count: 5,
+        metadata: null,
+        uploaded_by: null,
+        created_at: '2026-01-01T00:00:00Z',
+        updated_at: '2026-01-01T00:00:00Z',
+        ...overrides,
+    };
+}
+function makeStore(doc) {
+    return {
+        getDocument: vi.fn(async () => doc),
+        createEntityRelation: vi.fn(async () => undefined),
+        deleteEntityRelation: vi.fn(async () => undefined),
+    };
+}
+describe('DOCUMENT_RELATIONSHIP_TYPE', () => {
+    it('is the string "document"', () => {
+        expect(DOCUMENT_RELATIONSHIP_TYPE).toBe('document');
+    });
+});
+describe('linkDocumentToEntity', () => {
+    it('creates an entity relation from entity to document entity', async () => {
+        const doc = makeDoc({ id: 'doc-1', entity_id: 'doc-entity-1' });
+        const store = makeStore(doc);
+        await linkDocumentToEntity(store, 'doc-1', 'company-1', 'tenant-1');
+        expect(store.createEntityRelation).toHaveBeenCalledWith({
+            tenantId: 'tenant-1',
+            fromEntityId: 'company-1',
+            toEntityId: 'doc-entity-1',
+            relationshipType: 'document',
+        });
+    });
+    it('throws when document is not found', async () => {
+        const store = makeStore(null);
+        await expect(linkDocumentToEntity(store, 'missing-doc', 'company-1', 'tenant-1')).rejects.toThrow('Document not found: missing-doc');
+    });
+    it('throws when document has no entity representation', async () => {
+        const doc = makeDoc({ entity_id: null });
+        const store = makeStore(doc);
+        await expect(linkDocumentToEntity(store, 'doc-1', 'company-1', 'tenant-1')).rejects.toThrow('has no entity representation');
+    });
+    it('looks up the document by the provided documentId', async () => {
+        const doc = makeDoc({ id: 'doc-42' });
+        const store = makeStore(doc);
+        await linkDocumentToEntity(store, 'doc-42', 'entity-1', 'tenant-1');
+        expect(store.getDocument).toHaveBeenCalledWith('doc-42');
+    });
+});
+describe('unlinkDocumentFromEntity', () => {
+    it('deletes the entity relation', async () => {
+        const doc = makeDoc({ entity_id: 'doc-entity-1' });
+        const store = makeStore(doc);
+        await unlinkDocumentFromEntity(store, 'doc-1', 'company-1', 'tenant-1');
+        expect(store.deleteEntityRelation).toHaveBeenCalledWith({
+            tenantId: 'tenant-1',
+            fromEntityId: 'company-1',
+            toEntityId: 'doc-entity-1',
+            relationshipType: 'document',
+        });
+    });
+    it('throws when document is not found', async () => {
+        const store = makeStore(null);
+        await expect(unlinkDocumentFromEntity(store, 'missing-doc', 'company-1', 'tenant-1')).rejects.toThrow('Document not found: missing-doc');
+    });
+    it('silently succeeds when document has no entity_id', async () => {
+        const doc = makeDoc({ entity_id: null });
+        const store = makeStore(doc);
+        await expect(unlinkDocumentFromEntity(store, 'doc-1', 'company-1', 'tenant-1')).resolves.toBeUndefined();
+        expect(store.deleteEntityRelation).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=linking.test.js.map

package/dist/document/linking.test.js.map

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

package/dist/document/pagination.d.ts

@@ -0,0 +1,24 @@
+import type { DocumentChunkRecord } from '@sprinterai/core';
+/** Minimal store surface required for document page retrieval. */
+export interface DocumentPageStore {
+    /** List all chunks/pages for a document, ordered by page number. */
+    getDocumentChunks(documentId: string): Promise<DocumentChunkRecord[]>;
+}
+/**
+ * Get all pages (chunks) for a document, ordered by page number.
+ *
+ * @param store - Document store.
+ * @param documentId - The document whose pages to retrieve.
+ * @returns Ordered array of document chunks. Empty if document has no pages yet.
+ */
+export declare function getDocumentPages(store: DocumentPageStore, documentId: string): Promise<DocumentChunkRecord[]>;
+/**
+ * Get a specific page by page number.
+ *
+ * @param store - Document store.
+ * @param documentId - The document to query.
+ * @param pageNumber - 1-based page number.
+ * @returns The chunk for that page, or null if not found.
+ */
+export declare function getDocumentPage(store: DocumentPageStore, documentId: string, pageNumber: number): Promise<DocumentChunkRecord | null>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/document/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/document/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;CACvE;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAGhC;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAGrC"}

package/dist/document/pagination.js

@@ -0,0 +1,24 @@
+/**
+ * Get all pages (chunks) for a document, ordered by page number.
+ *
+ * @param store - Document store.
+ * @param documentId - The document whose pages to retrieve.
+ * @returns Ordered array of document chunks. Empty if document has no pages yet.
+ */
+export async function getDocumentPages(store, documentId) {
+    const chunks = await store.getDocumentChunks(documentId);
+    return chunks.slice().sort((a, b) => a.chunk_index - b.chunk_index);
+}
+/**
+ * Get a specific page by page number.
+ *
+ * @param store - Document store.
+ * @param documentId - The document to query.
+ * @param pageNumber - 1-based page number.
+ * @returns The chunk for that page, or null if not found.
+ */
+export async function getDocumentPage(store, documentId, pageNumber) {
+    const chunks = await store.getDocumentChunks(documentId);
+    return chunks.find((c) => c.chunk_index === pageNumber - 1) ?? null;
+}
+//# sourceMappingURL=pagination.js.map

package/dist/document/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/document/pagination.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAwB,EACxB,UAAkB;IAElB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAwB,EACxB,UAAkB,EAClB,UAAkB;IAElB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,UAAU,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;AACtE,CAAC"}

package/dist/document/pagination.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pagination.test.d.ts.map

package/dist/document/pagination.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.test.d.ts","sourceRoot":"","sources":["../../src/document/pagination.test.ts"],"names":[],"mappings":""}

package/dist/document/pagination.test.js

@@ -0,0 +1,84 @@
+import { describe, it, expect, vi } from 'vitest';
+import { getDocumentPages, getDocumentPage } from './pagination.js';
+function makeChunk(overrides) {
+    return {
+        document_id: 'doc-1',
+        tenant_id: 'tenant-1',
+        chunk_index: 0,
+        content: 'Test content',
+        metadata: null,
+        created_at: '2026-01-01T00:00:00Z',
+        ...overrides,
+    };
+}
+function makeStore(chunks) {
+    return {
+        getDocumentChunks: vi.fn(async () => chunks),
+    };
+}
+describe('getDocumentPages', () => {
+    it('returns chunks sorted by chunk index', async () => {
+        const chunks = [
+            makeChunk({ id: 'c3', chunk_index: 2 }),
+            makeChunk({ id: 'c1', chunk_index: 0 }),
+            makeChunk({ id: 'c2', chunk_index: 1 }),
+        ];
+        const store = makeStore(chunks);
+        const result = await getDocumentPages(store, 'doc-1');
+        expect(result[0].id).toBe('c1');
+        expect(result[1].id).toBe('c2');
+        expect(result[2].id).toBe('c3');
+    });
+    it('calls store with the correct documentId', async () => {
+        const store = makeStore([]);
+        await getDocumentPages(store, 'doc-42');
+        expect(store.getDocumentChunks).toHaveBeenCalledWith('doc-42');
+    });
+    it('returns empty array when no pages exist', async () => {
+        const store = makeStore([]);
+        const result = await getDocumentPages(store, 'doc-1');
+        expect(result).toHaveLength(0);
+    });
+    it('handles chunks in reverse order', async () => {
+        const chunks = [
+            makeChunk({ id: 'c1', chunk_index: 2 }),
+            makeChunk({ id: 'c2', chunk_index: 0 }),
+        ];
+        const store = makeStore(chunks);
+        const result = await getDocumentPages(store, 'doc-1');
+        expect(result[0].id).toBe('c2');
+        expect(result[1].id).toBe('c1');
+    });
+    it('does not mutate the original array', async () => {
+        const chunks = [
+            makeChunk({ id: 'c2', chunk_index: 1 }),
+            makeChunk({ id: 'c1', chunk_index: 0 }),
+        ];
+        const store = makeStore(chunks);
+        await getDocumentPages(store, 'doc-1');
+        // Original order unchanged
+        expect(chunks[0].id).toBe('c2');
+    });
+});
+describe('getDocumentPage', () => {
+    it('returns the chunk matching the page number', async () => {
+        const chunks = [
+            makeChunk({ id: 'c1', chunk_index: 0 }),
+            makeChunk({ id: 'c2', chunk_index: 1 }),
+        ];
+        const store = makeStore(chunks);
+        const result = await getDocumentPage(store, 'doc-1', 2);
+        expect(result?.id).toBe('c2');
+    });
+    it('returns null when page does not exist', async () => {
+        const store = makeStore([makeChunk({ id: 'c1', chunk_index: 0 })]);
+        const result = await getDocumentPage(store, 'doc-1', 99);
+        expect(result).toBeNull();
+    });
+    it('returns null for empty document', async () => {
+        const store = makeStore([]);
+        const result = await getDocumentPage(store, 'doc-1', 1);
+        expect(result).toBeNull();
+    });
+});
+//# sourceMappingURL=pagination.test.js.map

package/dist/document/pagination.test.js.map

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

package/dist/document/search.d.ts

@@ -0,0 +1,37 @@
+import type { DocumentChunkRecord } from '@sprinterai/core';
+/** Minimal store surface required for document search. */
+export interface DocumentSearchStore {
+    /** Full-text search across document chunks. */
+    searchDocumentChunks(query: string, options?: {
+        documentId?: string;
+        tenantId?: string;
+        limit?: number;
+    }): Promise<DocumentChunkRecord[]>;
+}
+/**
+ * Search within a specific document's pages using full-text search.
+ *
+ * @param store - Document store.
+ * @param documentId - Restrict search to this document.
+ * @param query - The search query (web-search style).
+ * @param options.limit - Maximum results to return (default 25).
+ * @returns Matching chunks ordered by relevance.
+ */
+export declare function searchDocumentPages(store: DocumentSearchStore, documentId: string, query: string, options?: {
+    limit?: number;
+}): Promise<DocumentChunkRecord[]>;
+/**
+ * Search across all documents in a tenant.
+ *
+ * @param store - Document store.
+ * @param tenantId - Scope the search to this tenant.
+ * @param query - The search query.
+ * @param options.limit - Maximum results to return (default 25).
+ * @param options.documentIds - Restrict to specific document IDs.
+ * @returns Matching chunks ordered by relevance.
+ */
+export declare function searchAllDocuments(store: DocumentSearchStore, tenantId: string, query: string, options?: {
+    limit?: number;
+    documentIds?: string[];
+}): Promise<DocumentChunkRecord[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/document/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/document/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,oBAAoB,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACnE,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAKhC;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GACvD,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAYhC"}

package/dist/document/search.js

@@ -0,0 +1,37 @@
+/**
+ * Search within a specific document's pages using full-text search.
+ *
+ * @param store - Document store.
+ * @param documentId - Restrict search to this document.
+ * @param query - The search query (web-search style).
+ * @param options.limit - Maximum results to return (default 25).
+ * @returns Matching chunks ordered by relevance.
+ */
+export async function searchDocumentPages(store, documentId, query, options = {}) {
+    return store.searchDocumentChunks(query, {
+        documentId,
+        limit: options.limit ?? 25,
+    });
+}
+/**
+ * Search across all documents in a tenant.
+ *
+ * @param store - Document store.
+ * @param tenantId - Scope the search to this tenant.
+ * @param query - The search query.
+ * @param options.limit - Maximum results to return (default 25).
+ * @param options.documentIds - Restrict to specific document IDs.
+ * @returns Matching chunks ordered by relevance.
+ */
+export async function searchAllDocuments(store, tenantId, query, options = {}) {
+    const results = await store.searchDocumentChunks(query, {
+        tenantId,
+        limit: options.limit ?? 25,
+    });
+    if (options.documentIds && options.documentIds.length > 0) {
+        const allowed = new Set(options.documentIds);
+        return results.filter((c) => allowed.has(c.document_id));
+    }
+    return results;
+}
+//# sourceMappingURL=search.js.map

package/dist/document/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/document/search.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAA0B,EAC1B,UAAkB,EAClB,KAAa,EACb,UAA8B,EAAE;IAEhC,OAAO,KAAK,CAAC,oBAAoB,CAAC,KAAK,EAAE;QACvC,UAAU;QACV,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;KAC3B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAA0B,EAC1B,QAAgB,EAChB,KAAa,EACb,UAAsD,EAAE;IAExD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,oBAAoB,CAAC,KAAK,EAAE;QACtD,QAAQ;QACR,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;KAC3B,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/document/search.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search.test.d.ts.map

package/dist/document/search.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.test.d.ts","sourceRoot":"","sources":["../../src/document/search.test.ts"],"names":[],"mappings":""}

package/dist/document/search.test.js

@@ -0,0 +1,97 @@
+import { describe, it, expect, vi } from 'vitest';
+import { searchDocumentPages, searchAllDocuments } from './search.js';
+function makeChunk(overrides) {
+    return {
+        document_id: 'doc-1',
+        tenant_id: 'tenant-1',
+        chunk_index: 0,
+        content: 'Matching content',
+        metadata: null,
+        created_at: '2026-01-01T00:00:00Z',
+        ...overrides,
+    };
+}
+function makeStore(results) {
+    return {
+        searchDocumentChunks: vi.fn(async () => results),
+    };
+}
+describe('searchDocumentPages', () => {
+    it('delegates to searchDocumentChunks with documentId', async () => {
+        const store = makeStore([]);
+        await searchDocumentPages(store, 'doc-42', 'test query');
+        expect(store.searchDocumentChunks).toHaveBeenCalledWith('test query', {
+            documentId: 'doc-42',
+            limit: 25,
+        });
+    });
+    it('returns matching chunks', async () => {
+        const chunks = [
+            makeChunk({ id: 'c1', content: 'Revenue grew 20%' }),
+            makeChunk({ id: 'c2', content: 'Revenue declined Q3' }),
+        ];
+        const store = makeStore(chunks);
+        const result = await searchDocumentPages(store, 'doc-1', 'revenue');
+        expect(result).toHaveLength(2);
+        expect(result[0].id).toBe('c1');
+    });
+    it('passes custom limit to store', async () => {
+        const store = makeStore([]);
+        await searchDocumentPages(store, 'doc-1', 'query', { limit: 5 });
+        expect(store.searchDocumentChunks).toHaveBeenCalledWith('query', {
+            documentId: 'doc-1',
+            limit: 5,
+        });
+    });
+    it('returns empty array when no matches', async () => {
+        const store = makeStore([]);
+        const result = await searchDocumentPages(store, 'doc-1', 'nonexistent');
+        expect(result).toHaveLength(0);
+    });
+});
+describe('searchAllDocuments', () => {
+    it('passes tenantId to the store', async () => {
+        const store = makeStore([]);
+        await searchAllDocuments(store, 'tenant-1', 'test');
+        expect(store.searchDocumentChunks).toHaveBeenCalledWith('test', {
+            tenantId: 'tenant-1',
+            limit: 25,
+        });
+    });
+    it('filters by documentIds when provided', async () => {
+        const chunks = [
+            makeChunk({ id: 'c1', document_id: 'doc-1' }),
+            makeChunk({ id: 'c2', document_id: 'doc-2' }),
+            makeChunk({ id: 'c3', document_id: 'doc-3' }),
+        ];
+        const store = makeStore(chunks);
+        const result = await searchAllDocuments(store, 'tenant-1', 'query', {
+            documentIds: ['doc-1', 'doc-3'],
+        });
+        expect(result).toHaveLength(2);
+        expect(result.map((c) => c.id)).toEqual(['c1', 'c3']);
+    });
+    it('returns all results when no documentIds filter', async () => {
+        const chunks = [
+            makeChunk({ id: 'c1', document_id: 'doc-1' }),
+            makeChunk({ id: 'c2', document_id: 'doc-2' }),
+        ];
+        const store = makeStore(chunks);
+        const result = await searchAllDocuments(store, 'tenant-1', 'query');
+        expect(result).toHaveLength(2);
+    });
+    it('passes custom limit to store', async () => {
+        const store = makeStore([]);
+        await searchAllDocuments(store, 'tenant-1', 'query', { limit: 10 });
+        expect(store.searchDocumentChunks).toHaveBeenCalledWith('query', {
+            tenantId: 'tenant-1',
+            limit: 10,
+        });
+    });
+    it('returns empty array when store returns no results', async () => {
+        const store = makeStore([]);
+        const result = await searchAllDocuments(store, 'tenant-1', 'query');
+        expect(result).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=search.test.js.map