@typicalday/firegraph 0.1.0

package/dist/client-Bk2Cm6xv.d.cts

@@ -0,0 +1,131 @@
+interface WhereClause {
+    field: string;
+    op: string;
+    value: string | number | boolean;
+}
+interface SummarizedRecord {
+    type: string;
+    uid: string;
+    data?: Record<string, unknown>;
+}
+interface SummarizedEdge {
+    fromType: string;
+    fromUid: string;
+    relation: string;
+    toType: string;
+    toUid: string;
+    data?: Record<string, unknown>;
+}
+interface SchemaResult {
+    nodeTypes: string[];
+    edgeTypes: {
+        relation: string;
+        from: string;
+        to: string;
+        inverseLabel: string | null;
+    }[];
+}
+interface GetNodeDetailInput {
+    uid: string;
+}
+interface NodeDetailResult {
+    node: SummarizedRecord | null;
+    outEdges: SummarizedEdge[];
+    inEdges: SummarizedEdge[];
+}
+interface GetNodesInput {
+    type?: string;
+    limit?: number;
+    startAfter?: string;
+    sortBy?: string;
+    sortDir?: 'asc' | 'desc';
+    where?: WhereClause[];
+}
+interface GetNodesResult {
+    nodes: SummarizedRecord[];
+    hasMore: boolean;
+    nextCursor?: string | null;
+}
+interface GetEdgesInput {
+    aType?: string;
+    aUid?: string;
+    axbType?: string;
+    bType?: string;
+    bUid?: string;
+    limit?: number;
+    startAfter?: string;
+    sortBy?: string;
+    sortDir?: 'asc' | 'desc';
+    where?: WhereClause[];
+}
+interface GetEdgesResult {
+    edges: SummarizedEdge[];
+    hasMore: boolean;
+    nextCursor?: string | null;
+}
+interface TraverseHop {
+    axbType: string;
+    direction?: 'forward' | 'reverse';
+    limit?: number;
+    aType?: string;
+    bType?: string;
+    orderBy?: {
+        field: string;
+        direction?: 'asc' | 'desc';
+    };
+    where?: WhereClause[];
+}
+interface TraverseInput {
+    startUid: string;
+    hops: TraverseHop[];
+    maxReads?: number;
+    concurrency?: number;
+}
+interface TraverseHopResult {
+    relation: string;
+    direction: string;
+    depth: number;
+    edgeCount: number;
+    edges: SummarizedEdge[];
+    truncated: boolean;
+}
+interface TraverseResult {
+    hops: TraverseHopResult[];
+    totalReads: number;
+    truncated: boolean;
+}
+interface SearchInput {
+    q: string;
+    limit?: number;
+}
+interface SearchResult {
+    results: (SummarizedRecord & {
+        matchType: string | null;
+    })[];
+}
+interface QueryClientOptions {
+    /** Editor server port. Default: auto-detected from config, fallback 3884. */
+    port?: number;
+    /** Editor server hostname. Default: 'localhost'. */
+    host?: string;
+}
+
+type QueryClientErrorCode = 'VALIDATION_ERROR' | 'CONNECTION_FAILED' | 'SERVER_ERROR';
+declare class QueryClientError extends Error {
+    readonly code: QueryClientErrorCode;
+    constructor(message: string, code: QueryClientErrorCode);
+}
+declare class QueryClient {
+    private readonly baseUrl;
+    constructor(options?: QueryClientOptions);
+    private query;
+    private mutate;
+    getSchema(): Promise<SchemaResult>;
+    getNodeDetail(input: GetNodeDetailInput): Promise<NodeDetailResult>;
+    getNodes(input: GetNodesInput): Promise<GetNodesResult>;
+    getEdges(input: GetEdgesInput): Promise<GetEdgesResult>;
+    traverse(input: TraverseInput): Promise<TraverseResult>;
+    search(input: SearchInput): Promise<SearchResult>;
+}
+
+export { type GetEdgesInput as G, type NodeDetailResult as N, QueryClient as Q, type SummarizedEdge as S, type TraverseHop as T, type WhereClause as W, QueryClientError as a, type QueryClientErrorCode as b, type QueryClientOptions as c, type SummarizedRecord as d, type GetEdgesResult as e, type GetNodeDetailInput as f, type GetNodesInput as g, type GetNodesResult as h, type SchemaResult as i, type SearchInput as j, type SearchResult as k, type TraverseHopResult as l, type TraverseInput as m, type TraverseResult as n };

package/dist/client-Bk2Cm6xv.d.ts

@@ -0,0 +1,131 @@
+interface WhereClause {
+    field: string;
+    op: string;
+    value: string | number | boolean;
+}
+interface SummarizedRecord {
+    type: string;
+    uid: string;
+    data?: Record<string, unknown>;
+}
+interface SummarizedEdge {
+    fromType: string;
+    fromUid: string;
+    relation: string;
+    toType: string;
+    toUid: string;
+    data?: Record<string, unknown>;
+}
+interface SchemaResult {
+    nodeTypes: string[];
+    edgeTypes: {
+        relation: string;
+        from: string;
+        to: string;
+        inverseLabel: string | null;
+    }[];
+}
+interface GetNodeDetailInput {
+    uid: string;
+}
+interface NodeDetailResult {
+    node: SummarizedRecord | null;
+    outEdges: SummarizedEdge[];
+    inEdges: SummarizedEdge[];
+}
+interface GetNodesInput {
+    type?: string;
+    limit?: number;
+    startAfter?: string;
+    sortBy?: string;
+    sortDir?: 'asc' | 'desc';
+    where?: WhereClause[];
+}
+interface GetNodesResult {
+    nodes: SummarizedRecord[];
+    hasMore: boolean;
+    nextCursor?: string | null;
+}
+interface GetEdgesInput {
+    aType?: string;
+    aUid?: string;
+    axbType?: string;
+    bType?: string;
+    bUid?: string;
+    limit?: number;
+    startAfter?: string;
+    sortBy?: string;
+    sortDir?: 'asc' | 'desc';
+    where?: WhereClause[];
+}
+interface GetEdgesResult {
+    edges: SummarizedEdge[];
+    hasMore: boolean;
+    nextCursor?: string | null;
+}
+interface TraverseHop {
+    axbType: string;
+    direction?: 'forward' | 'reverse';
+    limit?: number;
+    aType?: string;
+    bType?: string;
+    orderBy?: {
+        field: string;
+        direction?: 'asc' | 'desc';
+    };
+    where?: WhereClause[];
+}
+interface TraverseInput {
+    startUid: string;
+    hops: TraverseHop[];
+    maxReads?: number;
+    concurrency?: number;
+}
+interface TraverseHopResult {
+    relation: string;
+    direction: string;
+    depth: number;
+    edgeCount: number;
+    edges: SummarizedEdge[];
+    truncated: boolean;
+}
+interface TraverseResult {
+    hops: TraverseHopResult[];
+    totalReads: number;
+    truncated: boolean;
+}
+interface SearchInput {
+    q: string;
+    limit?: number;
+}
+interface SearchResult {
+    results: (SummarizedRecord & {
+        matchType: string | null;
+    })[];
+}
+interface QueryClientOptions {
+    /** Editor server port. Default: auto-detected from config, fallback 3884. */
+    port?: number;
+    /** Editor server hostname. Default: 'localhost'. */
+    host?: string;
+}
+
+type QueryClientErrorCode = 'VALIDATION_ERROR' | 'CONNECTION_FAILED' | 'SERVER_ERROR';
+declare class QueryClientError extends Error {
+    readonly code: QueryClientErrorCode;
+    constructor(message: string, code: QueryClientErrorCode);
+}
+declare class QueryClient {
+    private readonly baseUrl;
+    constructor(options?: QueryClientOptions);
+    private query;
+    private mutate;
+    getSchema(): Promise<SchemaResult>;
+    getNodeDetail(input: GetNodeDetailInput): Promise<NodeDetailResult>;
+    getNodes(input: GetNodesInput): Promise<GetNodesResult>;
+    getEdges(input: GetEdgesInput): Promise<GetEdgesResult>;
+    traverse(input: TraverseInput): Promise<TraverseResult>;
+    search(input: SearchInput): Promise<SearchResult>;
+}
+
+export { type GetEdgesInput as G, type NodeDetailResult as N, QueryClient as Q, type SummarizedEdge as S, type TraverseHop as T, type WhereClause as W, QueryClientError as a, type QueryClientErrorCode as b, type QueryClientOptions as c, type SummarizedRecord as d, type GetEdgesResult as e, type GetNodeDetailInput as f, type GetNodesInput as g, type GetNodesResult as h, type SchemaResult as i, type SearchInput as j, type SearchResult as k, type TraverseHopResult as l, type TraverseInput as m, type TraverseResult as n };

package/dist/codegen/index.cjs

@@ -0,0 +1,81 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/codegen/index.ts
+var codegen_exports = {};
+__export(codegen_exports, {
+  generateTypes: () => generateTypes
+});
+module.exports = __toCommonJS(codegen_exports);
+function pascalCase(s) {
+  return s.replace(
+    /(^|[^a-zA-Z0-9])([a-zA-Z])/g,
+    (_, _sep, ch) => ch.toUpperCase()
+  );
+}
+async function generateTypes(discovery, options = {}) {
+  const { compile } = await import("json-schema-to-typescript");
+  const { banner = true } = options;
+  const chunks = [];
+  if (banner) {
+    chunks.push(
+      "// Auto-generated by firegraph codegen \u2014 do not edit manually\n"
+    );
+  }
+  const sortedNodes = [...discovery.nodes.entries()].sort(
+    ([a], [b]) => a.localeCompare(b)
+  );
+  const sortedEdges = [...discovery.edges.entries()].sort(
+    ([a], [b]) => a.localeCompare(b)
+  );
+  for (const [name, entity] of sortedNodes) {
+    const typeName = `${pascalCase(name)}Data`;
+    const ts = await compile(entity.schema, typeName, {
+      bannerComment: "",
+      additionalProperties: false
+    });
+    chunks.push(ts.trim());
+    chunks.push("");
+  }
+  for (const [name, entity] of sortedEdges) {
+    const typeName = `${pascalCase(name)}EdgeData`;
+    const ts = await compile(entity.schema, typeName, {
+      bannerComment: "",
+      additionalProperties: false
+    });
+    chunks.push(ts.trim());
+    chunks.push("");
+  }
+  return chunks.join("\n").trimEnd() + "\n";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateTypes
+});
+//# sourceMappingURL=index.cjs.map

package/dist/codegen/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/codegen/index.ts"],"sourcesContent":["/**\n * Code generation — produces TypeScript type definitions from JSON Schema\n * files discovered via the entity folder convention.\n *\n * Uses `json-schema-to-typescript` to compile each entity's `schema.json`\n * into a TypeScript interface.\n *\n * Naming convention:\n * - Nodes:  `{PascalName}Data`       (e.g. `TaskData`)\n * - Edges:  `{PascalName}EdgeData`   (e.g. `HasStepEdgeData`)\n */\n\nimport type { DiscoveryResult } from '../types.js';\n\nfunction pascalCase(s: string): string {\n  return s.replace(/(^|[^a-zA-Z0-9])([a-zA-Z])/g, (_, _sep, ch) =>\n    ch.toUpperCase(),\n  );\n}\n\nexport interface CodegenOptions {\n  /** Add banner comment at top of output. Defaults to true. */\n  banner?: boolean;\n}\n\n/**\n * Generate TypeScript type definitions from a DiscoveryResult.\n * Returns the full file content as a string.\n */\nexport async function generateTypes(\n  discovery: DiscoveryResult,\n  options: CodegenOptions = {},\n): Promise<string> {\n  // Lazy-load to avoid requiring this dep at runtime for non-codegen usage\n  const { compile } = await import('json-schema-to-typescript');\n\n  const { banner = true } = options;\n  const chunks: string[] = [];\n\n  if (banner) {\n    chunks.push(\n      '// Auto-generated by firegraph codegen — do not edit manually\\n',\n    );\n  }\n\n  // Sort for deterministic output\n  const sortedNodes = [...discovery.nodes.entries()].sort(([a], [b]) =>\n    a.localeCompare(b),\n  );\n  const sortedEdges = [...discovery.edges.entries()].sort(([a], [b]) =>\n    a.localeCompare(b),\n  );\n\n  for (const [name, entity] of sortedNodes) {\n    const typeName = `${pascalCase(name)}Data`;\n    const ts = await compile(entity.schema as any, typeName, {\n      bannerComment: '',\n      additionalProperties: false,\n    });\n    chunks.push(ts.trim());\n    chunks.push('');\n  }\n\n  for (const [name, entity] of sortedEdges) {\n    const typeName = `${pascalCase(name)}EdgeData`;\n    const ts = await compile(entity.schema as any, typeName, {\n      bannerComment: '',\n      additionalProperties: false,\n    });\n    chunks.push(ts.trim());\n    chunks.push('');\n  }\n\n  return chunks.join('\\n').trimEnd() + '\\n';\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAcA,SAAS,WAAW,GAAmB;AACrC,SAAO,EAAE;AAAA,IAAQ;AAAA,IAA+B,CAAC,GAAG,MAAM,OACxD,GAAG,YAAY;AAAA,EACjB;AACF;AAWA,eAAsB,cACpB,WACA,UAA0B,CAAC,GACV;AAEjB,QAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,2BAA2B;AAE5D,QAAM,EAAE,SAAS,KAAK,IAAI;AAC1B,QAAM,SAAmB,CAAC;AAE1B,MAAI,QAAQ;AACV,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AAGA,QAAM,cAAc,CAAC,GAAG,UAAU,MAAM,QAAQ,CAAC,EAAE;AAAA,IAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAC9D,EAAE,cAAc,CAAC;AAAA,EACnB;AACA,QAAM,cAAc,CAAC,GAAG,UAAU,MAAM,QAAQ,CAAC,EAAE;AAAA,IAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAC9D,EAAE,cAAc,CAAC;AAAA,EACnB;AAEA,aAAW,CAAC,MAAM,MAAM,KAAK,aAAa;AACxC,UAAM,WAAW,GAAG,WAAW,IAAI,CAAC;AACpC,UAAM,KAAK,MAAM,QAAQ,OAAO,QAAe,UAAU;AAAA,MACvD,eAAe;AAAA,MACf,sBAAsB;AAAA,IACxB,CAAC;AACD,WAAO,KAAK,GAAG,KAAK,CAAC;AACrB,WAAO,KAAK,EAAE;AAAA,EAChB;AAEA,aAAW,CAAC,MAAM,MAAM,KAAK,aAAa;AACxC,UAAM,WAAW,GAAG,WAAW,IAAI,CAAC;AACpC,UAAM,KAAK,MAAM,QAAQ,OAAO,QAAe,UAAU;AAAA,MACvD,eAAe;AAAA,MACf,sBAAsB;AAAA,IACxB,CAAC;AACD,WAAO,KAAK,GAAG,KAAK,CAAC;AACrB,WAAO,KAAK,EAAE;AAAA,EAChB;AAEA,SAAO,OAAO,KAAK,IAAI,EAAE,QAAQ,IAAI;AACvC;","names":[]}

package/dist/codegen/index.d.cts

@@ -0,0 +1,2 @@
+export { k as CodegenOptions, I as generateTypes } from '../index-CG3R68Hu.cjs';
+import '@google-cloud/firestore';

package/dist/codegen/index.d.ts

@@ -0,0 +1,2 @@
+export { k as CodegenOptions, I as generateTypes } from '../index-CG3R68Hu.js';
+import '@google-cloud/firestore';

package/dist/codegen/index.js

@@ -0,0 +1,7 @@
+import {
+  generateTypes
+} from "../chunk-YLGXLEUE.js";
+export {
+  generateTypes
+};
+//# sourceMappingURL=index.js.map

package/dist/codegen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}