@oddington/sdk 0.1.31 → 0.1.33

package/dist/types/packages/sdk/src/data-schema-types.d.ts

@@ -142,7 +142,9 @@ type SelectedNames<Schema extends Collection, Query> = Query extends {
 } ? Extract<Name, Fields<Schema>['name']> : Fields<Schema>['name'];
 type Expanded<Schemas extends Catalogue, F, Query> = F extends {
     kind: 'link';
-} ? Cardinality<F, Project<Schemas, Targets<Schemas, F>, Query>> | (F extends {
+} ? Cardinality<F, Project<Schemas, Targets<Schemas, F>, Query> & {
+    $fragment?: string;
+}> | (F extends {
     many: false;
 } ? '$' extends keyof Query ? 'where' extends keyof NonNullable<Query['$']> ? null : never : never : never) : never;
 type Project<Schemas extends Catalogue, Schema extends Collection, Query> = Schema extends Collection ? {

package/dist/types/packages/sdk/src/public.d.ts

@@ -34,6 +34,8 @@ export declare const data: {
     repository<const Name extends string>(name: Name): import('./data-schema-types.js').RepositoryFor<Name>;
 };
 export { FileOperationError } from '../../../shared/files-contract.js';
+export { source } from './source.js';
+export type { SourceLocation, OsSourceLocation, GmailSourceLocation, DropboxSourceLocation } from './source.js';
 export { InboxOperationError } from '../../../shared/inbox-member-contract.js';
 export type { InboxMember, InboxCurrent, InboxItem, AnswerableQuestion, QuestionSnapshot, ResponseConsequence, LinkedAskSnapshot, AskUpdate, DigestReadConfirmation, RecipientCandidate, RecipientAddition, ResponseAcceptance, InboxAnswerInput, InboxSearchInput } from '../../../shared/inbox-member-types.js';
 export type { RecordSelectionResult } from '../../../shared/record-selection.js';

package/dist/types/packages/sdk/src/source.d.ts

@@ -0,0 +1,57 @@
+import type { DataValue } from '../../../shared/data-contract.js';
+import type { File } from '../../../shared/files-contract.js';
+export type SourceLocation = {
+    provider: string;
+    [field: string]: DataValue;
+};
+export type OsSourceLocation = {
+    provider: 'os';
+    file: string;
+};
+export type GmailSourceLocation = {
+    provider: 'gmail';
+    connection: string;
+    message: string;
+    attachment: string;
+    url?: string;
+};
+export type DropboxSourceLocation = {
+    provider: 'dropbox';
+    connection: string;
+    file: string;
+    revision?: string;
+    path?: string;
+    url?: string;
+};
+/** Pure authoring conveniences; ordinary Data validation and publication own writes. */
+export declare const source: {
+    file(input: {
+        $ref: string;
+        file: File;
+        locations: readonly SourceLocation[];
+    }): {
+        $ref: string;
+        type: 'source';
+        kind: 'file';
+        filename: string;
+        media_type: string;
+        size_bytes: number;
+        sha256: string;
+        locations: {
+            [field: string]: DataValue;
+            provider: string;
+        }[];
+    };
+    location: {
+        os(file: Pick<File, 'id'>): OsSourceLocation;
+        gmail(input: Omit<GmailSourceLocation, 'provider'>): GmailSourceLocation;
+        dropbox(input: Omit<DropboxSourceLocation, 'provider'>): DropboxSourceLocation;
+    };
+    locations: {
+        merge(existing: readonly SourceLocation[], incoming: readonly SourceLocation[]): SourceLocation[];
+    };
+    csv: {
+        /** One-based CSV record position; a present header is record 1. */
+        row(baseRef: string, row: number): string;
+    };
+};

package/dist/types/shared/data-contract.d.ts

@@ -94,6 +94,9 @@ export type SelectedRecord = {
     $ref: string;
     $version: string;
     [field: string]: DataValue;
+} & {
+    /** Present only on an expanded qualified link occurrence. */
+    $fragment?: string;
 };
 export type SelectionMetadata = {
     version: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddington/sdk",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "description": "OS routine and response-handler SDK",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",