@clidey/whodb-sdk 0.0.0

package/dist/generated/surface.d.ts

@@ -0,0 +1,190 @@
+/** Facade surface mapping generated from sdk/spec/surface.yaml. */
+export declare const surface: {
+    readonly ontology: {
+        readonly entities: {
+            readonly operation: "OntologyEntities";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly entity: {
+            readonly operation: "OntologyEntity";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly describe: {
+            readonly operation: "OntologyDescribe";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly list: {
+            readonly operation: "OntologyRows";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: {
+                readonly pageSizeArg: "pageSize";
+                readonly pageOffsetArg: "pageOffset";
+            };
+        };
+        readonly query: {
+            readonly operation: "OntologyQuery";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly aggregate: {
+            readonly operation: "OntologyAggregate";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: {
+                readonly pageSizeArg: "pageSize";
+                readonly pageOffsetArg: "pageOffset";
+            };
+        };
+        readonly stats: {
+            readonly operation: "OntologyStats";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly similar: {
+            readonly operation: "OntologySimilar";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly followLink: {
+            readonly operation: "OntologyFollowLink";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: {
+                readonly pageSizeArg: "pageSize";
+                readonly pageOffsetArg: "pageOffset";
+            };
+        };
+        readonly followIncomingLink: {
+            readonly operation: "OntologyFollowIncomingLink";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: {
+                readonly pageSizeArg: "pageSize";
+                readonly pageOffsetArg: "pageOffset";
+            };
+        };
+        readonly fastLookups: {
+            readonly operation: "OntologyFastLookups";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly create: {
+            readonly operation: "OntologyAddRow";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly createMany: {
+            readonly operation: "OntologyAddRows";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly update: {
+            readonly operation: "OntologyUpdateRow";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly delete: {
+            readonly operation: "OntologyDeleteRow";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+    };
+    readonly dataset: {
+        readonly list: {
+            readonly operation: "ProjectDatasets";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly rows: {
+            readonly operation: "QueryDataset";
+            readonly autofill: {};
+            readonly rename: {};
+            readonly paginated: null;
+        };
+    };
+    readonly source: {
+        readonly list: {
+            readonly operation: "ProjectSources";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly rows: {
+            readonly operation: "PlatformSourceRows";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: {
+                readonly pageSizeArg: "pageSize";
+                readonly pageOffsetArg: "pageOffset";
+            };
+        };
+        readonly objects: {
+            readonly operation: "PlatformSourceObjects";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly columns: {
+            readonly operation: "PlatformSourceColumns";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+    };
+};

package/dist/generated/surface.js

@@ -0,0 +1,191 @@
+// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 4b84678f5fe7)
+/** Facade surface mapping generated from sdk/spec/surface.yaml. */
+export const surface = {
+    "ontology": {
+        "entities": {
+            "operation": "OntologyEntities",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "entity": {
+            "operation": "OntologyEntity",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "describe": {
+            "operation": "OntologyDescribe",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "list": {
+            "operation": "OntologyRows",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": {
+                "pageSizeArg": "pageSize",
+                "pageOffsetArg": "pageOffset"
+            }
+        },
+        "query": {
+            "operation": "OntologyQuery",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "aggregate": {
+            "operation": "OntologyAggregate",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": {
+                "pageSizeArg": "pageSize",
+                "pageOffsetArg": "pageOffset"
+            }
+        },
+        "stats": {
+            "operation": "OntologyStats",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "similar": {
+            "operation": "OntologySimilar",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "followLink": {
+            "operation": "OntologyFollowLink",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": {
+                "pageSizeArg": "pageSize",
+                "pageOffsetArg": "pageOffset"
+            }
+        },
+        "followIncomingLink": {
+            "operation": "OntologyFollowIncomingLink",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": {
+                "pageSizeArg": "pageSize",
+                "pageOffsetArg": "pageOffset"
+            }
+        },
+        "fastLookups": {
+            "operation": "OntologyFastLookups",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "create": {
+            "operation": "OntologyAddRow",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "createMany": {
+            "operation": "OntologyAddRows",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "update": {
+            "operation": "OntologyUpdateRow",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "delete": {
+            "operation": "OntologyDeleteRow",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        }
+    },
+    "dataset": {
+        "list": {
+            "operation": "ProjectDatasets",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "rows": {
+            "operation": "QueryDataset",
+            "autofill": {},
+            "rename": {},
+            "paginated": null
+        }
+    },
+    "source": {
+        "list": {
+            "operation": "ProjectSources",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "rows": {
+            "operation": "PlatformSourceRows",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": {
+                "pageSizeArg": "pageSize",
+                "pageOffsetArg": "pageOffset"
+            }
+        },
+        "objects": {
+            "operation": "PlatformSourceObjects",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "columns": {
+            "operation": "PlatformSourceColumns",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        }
+    }
+};

package/dist/generated/types.d.ts

@@ -0,0 +1,302 @@
+export interface AtomicWhereCondition {
+    ColumnType: string;
+    Key: string;
+    Operator: string;
+    Value: string;
+}
+export interface Column {
+    Type: string;
+    Name: string;
+    MetadataFidelity: SourceMetadataFidelity;
+    IsPrimary: boolean;
+    IsForeignKey: boolean;
+    ReferencedTable?: string | null;
+    ReferencedColumn?: string | null;
+    Length?: number | null;
+    Precision?: number | null;
+    Scale?: number | null;
+}
+export interface ColumnDef {
+    name: string;
+    type: string;
+    isNullable: boolean;
+    isPrimary: boolean;
+}
+export interface Dataset {
+    id: string;
+    projectId: string;
+    sourceId: string;
+    name: string;
+    description: string;
+    schema: Array<ColumnDef>;
+    schemaMode: string;
+    ownerId: string;
+    rowCount: number;
+    sizeBytes: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DatasetQueryResult {
+    columns: Array<string>;
+    rows: Array<Array<string>>;
+    total: number;
+}
+export interface OntologyAddRowsResult {
+    inserted: number;
+    ids: Array<string>;
+}
+export interface OntologyAggregateMetricInput {
+    field?: string | null;
+    op: string;
+    as?: string | null;
+}
+export interface OntologyCreateRowInput {
+    values: Array<RecordInput>;
+}
+export type OntologyDataType = 'String' | 'Integer' | 'Long' | 'Double' | 'Float' | 'Boolean' | 'Date' | 'Timestamp' | 'Array' | 'Struct' | 'UUID';
+export interface OntologyDescribeInput {
+    entities: Array<string>;
+    includeInferred: boolean;
+}
+export interface OntologyDescription {
+    text: string;
+    entities: Array<OntologyDescriptionEntity>;
+    relationships: Array<OntologyDescriptionRelationship>;
+}
+export interface OntologyDescriptionEntity {
+    name: string;
+    displayName: string;
+    description: string;
+    primaryKey: string;
+    fields: Array<OntologyDescriptionField>;
+}
+export interface OntologyDescriptionField {
+    name: string;
+    displayName: string;
+    description: string;
+    type: string;
+    required: boolean;
+    searchable: boolean;
+    sortable: boolean;
+}
+export interface OntologyDescriptionRelationship {
+    name: string;
+    source: string;
+    sourceField: string;
+    target: string;
+    targetField: string;
+    cardinality: string;
+    kind: string;
+}
+export interface OntologyFastLookup {
+    id: string;
+    entityId: string;
+    displayName: string;
+    fields: Array<string>;
+    status: string;
+    reason: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface OntologyLink {
+    id: string;
+    apiName: string;
+    targetOntologyApiName: string;
+    cardinality: OntologyLinkCardinality;
+    foreignKeyProperty: string;
+    targetForeignKeyProperty: string;
+    joinTable: string;
+    sourceColumnInJoinTable: string;
+    targetColumnInJoinTable: string;
+    displayName: string;
+    pluralDisplayName: string;
+    reverseDisplayName: string;
+}
+export type OntologyLinkCardinality = 'ONE_TO_ONE' | 'ONE_TO_MANY' | 'MANY_TO_ONE' | 'MANY_TO_MANY';
+export interface OntologyObjectType {
+    id: string;
+    projectId: string;
+    apiName: string;
+    displayName: string;
+    pluralDisplayName: string;
+    description: string;
+    primaryKey: string;
+    sourceId?: string | null;
+    tableName: string;
+    schemaName: string;
+    storageMode: OntologyStorageMode;
+    provisioningStatus: OntologyProvisioningStatus;
+    embeddingEnabled: boolean;
+    embeddingProperties: Array<string>;
+    status: OntologyStatus;
+    icon: string;
+    color: string;
+    createdAt: string;
+    updatedAt: string;
+    properties: Array<OntologyProperty>;
+    links: Array<OntologyLink>;
+}
+export interface OntologyProperty {
+    id: string;
+    apiName: string;
+    displayName: string;
+    description: string;
+    columnName: string;
+    dataType: OntologyDataType;
+    arrayElementType: string;
+    isRequired: boolean;
+    visibility: OntologyVisibility;
+    isSearchable: boolean;
+    isSortable: boolean;
+    isEditOnly: boolean;
+    sortOrder: number;
+}
+export type OntologyProvisioningStatus = 'provisioning' | 'ready' | 'failed';
+export interface OntologyQueryInput {
+    entity: string;
+    whereJson?: string | null;
+    search?: string | null;
+    searchFields?: Array<string> | null;
+    joins?: Array<OntologyQueryJoinInput> | null;
+    groupBy?: Array<string> | null;
+    metrics?: Array<OntologyQueryMetricInput> | null;
+    sort?: Array<OntologyQuerySortInput> | null;
+    pageSize?: number | null;
+    offset?: number | null;
+    scanLimit?: number | null;
+}
+export interface OntologyQueryJoinInput {
+    entity: string;
+    leftField: string;
+    rightField: string;
+    as?: string | null;
+    kind?: string | null;
+}
+export interface OntologyQueryMetricInput {
+    op: string;
+    field?: string | null;
+    as?: string | null;
+}
+export interface OntologyQuerySortInput {
+    field: string;
+    desc?: boolean | null;
+}
+export interface OntologySimilarInput {
+    entityId: string;
+    rowId: string;
+    topK: number;
+    properties?: Array<string> | null;
+    where?: WhereCondition | null;
+}
+export interface OntologySimilarityResult {
+    rows: Array<OntologySimilarityRow>;
+}
+export interface OntologySimilarityRow {
+    score: number;
+    values: Array<OntologySimilarityValue>;
+}
+export interface OntologySimilarityValue {
+    key: string;
+    value: string;
+}
+export interface OntologyStatsResult {
+    property: string;
+    min?: string | null;
+    max?: string | null;
+    total: number;
+    nonNull: number;
+}
+export type OntologyStatus = 'active' | 'experimental' | 'deprecated';
+export type OntologyStorageMode = 'operational' | 'analytical';
+export type OntologyVisibility = 'prominent' | 'normal' | 'hidden';
+export interface OperationWhereCondition {
+    Children: Array<WhereCondition>;
+}
+export interface Organization {
+    id: string;
+    name: string;
+    slug: string;
+    createdAt: string;
+}
+export interface PlatformSource {
+    id: string;
+    projectId: string;
+    name: string;
+    databaseType: string;
+    createdBy: string;
+    createdAt: string;
+    ingestionStatus: string;
+    lastEventAt?: string | null;
+    ingestionError: string;
+    eventsReceived: string;
+}
+export interface Project {
+    id: string;
+    orgId: string;
+    name: string;
+    slug: string;
+    description: string;
+    createdAt: string;
+}
+export interface QueryDatasetInput {
+    projectId: string;
+    datasetId: string;
+    pageSize: number;
+    pageOffset: number;
+}
+export interface Record {
+    Key: string;
+    Value: string;
+}
+export interface RecordInput {
+    Key: string;
+    Value: string;
+    Extra?: Array<RecordInput> | null;
+}
+export interface RowsResult {
+    Columns: Array<Column>;
+    Rows: Array<Array<string>>;
+    DisableUpdate: boolean;
+    TotalCount: number;
+}
+export interface SortCondition {
+    Column: string;
+    Direction: SortDirection;
+}
+export type SortDirection = 'ASC' | 'DESC';
+export type SourceAction = 'Browse' | 'Inspect' | 'ViewRows' | 'ViewContent' | 'ViewDefinition' | 'CreateChild' | 'Delete' | 'InsertData' | 'UpdateData' | 'DeleteData' | 'ImportData' | 'GenerateMockData' | 'Execute' | 'ViewGraph';
+export type SourceMetadataFidelity = 'Exact' | 'Driver' | 'Sampled' | 'Inferred' | 'Synthetic' | 'Unsupported' | 'Unknown';
+export interface SourceObject {
+    Ref: SourceObjectRef;
+    Kind: SourceObjectKind;
+    Name: string;
+    Path: Array<string>;
+    HasChildren: boolean;
+    Actions: Array<SourceAction>;
+    Metadata: Array<Record>;
+}
+export type SourceObjectKind = 'Database' | 'Schema' | 'Table' | 'View' | 'Collection' | 'Index' | 'Key' | 'Item' | 'Function' | 'Procedure' | 'Trigger' | 'Sequence';
+export interface SourceObjectRef {
+    Kind: SourceObjectKind;
+    Locator: string;
+    Path: Array<string>;
+}
+export interface SourceObjectRefInput {
+    Kind: SourceObjectKind;
+    Locator?: string | null;
+    Path: Array<string>;
+}
+export interface StatusResponse {
+    Status: boolean;
+}
+export interface WhereCondition {
+    Type: WhereConditionType;
+    Atomic?: AtomicWhereCondition | null;
+    And?: OperationWhereCondition | null;
+    Or?: OperationWhereCondition | null;
+}
+export type WhereConditionType = 'Atomic' | 'And' | 'Or';
+export interface Workspace {
+    orgId?: string | null;
+    projectId?: string | null;
+}

package/dist/generated/types.js

@@ -0,0 +1,2 @@
+// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 4b84678f5fe7)
+export {};

package/dist/hydrate.d.ts

@@ -0,0 +1,18 @@
+import type { DatasetQueryResult, OntologyObjectType, RowsResult } from './generated/types.js';
+/** A hydrated row: column name → native-typed value. */
+export type Row = Record<string, unknown>;
+/** Coerces one stringly-typed cell into its native type per the shared rules. */
+export declare function coerceValue(raw: string | null, columnType: string): unknown;
+/** Property-metadata type overrides: property apiName → ontology dataType. */
+export type PropertyTypes = Map<string, string>;
+/** Builds a property-type map from ontology entity metadata. */
+export declare function propertyTypesOf(entity: OntologyObjectType): PropertyTypes;
+/**
+ * Hydrates a stringly-typed result into native-typed row objects. Ontology
+ * property metadata, when supplied, overrides the wire column type — the
+ * ontology's dataType is more precise than the storage column type.
+ */
+export declare function hydrateRows(result: DatasetQueryResult | RowsResult, propertyTypes?: PropertyTypes): {
+    rows: Row[];
+    totalCount: number | null;
+};