@graphty/graph-io 0.3.48 → 0.3.50

package/dist/chunks/choose-Cdx6Enl2.js

@@ -1,57 +0,0 @@
-import { GraphBuilder } from "@graphty/graph-format";
-import { b as chooseGraph } from "./export-CZ7VRm4I.js";
-import { K as ImportReportBuilder } from "./report-CgdsL9Hb.js";
-async function importChosenGraph(importer, input, sink, options) {
-  const importAll = importer.importAll?.bind(importer);
-  if (importAll === void 0) {
-    return importer.import(input, sink, options);
-  }
-  const replay = await replayable(input);
-  const scratch = [];
-  await importAll(replay, (i) => scratch[i] = new GraphBuilder({ directed: false }), {
-    ...options,
-    onProgress: void 0
-  });
-  const names = scratch.map((b) => {
-    try {
-      return b.freeze().meta.name;
-    } catch {
-      return null;
-    }
-  });
-  const chosen = chooseGraph(names, options, new ImportReportBuilder(importer.format, 0));
-  const reports = await importAll(
-    replay,
-    (i) => i === chosen ? sink : new GraphBuilder({ directed: false }),
-    options
-  );
-  return reports[chosen];
-}
-async function replayable(input) {
-  if (typeof input === "string" || input instanceof Uint8Array) {
-    return input;
-  }
-  const parts = [];
-  const encoder = new TextEncoder();
-  if (typeof input.getReader === "function") {
-    const reader = input.getReader();
-    for (let r = await reader.read(); !r.done; r = await reader.read()) {
-      parts.push(r.value);
-    }
-  } else {
-    for await (const chunk of input) {
-      parts.push(typeof chunk === "string" ? encoder.encode(chunk) : chunk);
-    }
-  }
-  const out = new Uint8Array(parts.reduce((n, p) => n + p.byteLength, 0));
-  let offset = 0;
-  for (const part of parts) {
-    out.set(part, offset);
-    offset += part.byteLength;
-  }
-  return out;
-}
-export {
-  importChosenGraph as i
-};
-//# sourceMappingURL=choose-Cdx6Enl2.js.map

package/dist/chunks/choose-Cdx6Enl2.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"choose-Cdx6Enl2.js","sources":["../../src/common/choose.ts"],"sourcesContent":["/**\n * The graph choice of an importer that can read every graph of a file (importAll) but has no cheap\n * listing: `graphIndex` / `graphName` passed to its import() directly, as the registry would honor\n * them, so a caller with its own builder is not silently given the first graph.\n */\n\nimport { GraphBuilder, type GraphSink } from \"@graphty/graph-format\";\n\nimport {\n    type CommonImportOptions,\n    type GraphChoiceOptions,\n    type GraphImporter,\n    type ImportInput,\n    type ImportReport,\n} from \"../types.js\";\nimport { chooseGraph } from \"./options.js\";\nimport { ImportReportBuilder } from \"./report.js\";\n\n/**\n * Read the graph `graphIndex` or `graphName` chooses into the sink: every graph is read once into a\n * scratch builder to learn the names (E_GRAPH_NOT_FOUND lists them), then the input again with the\n * chosen graph going to the sink.\n * @param importer - the importer, which has importAll()\n * @param input - the input\n * @param sink - the caller's sink\n * @param options - the import options, with the choice\n * @returns the chosen graph's report\n */\nexport async function importChosenGraph<O>(\n    importer: GraphImporter<O>,\n    input: ImportInput,\n    sink: GraphSink,\n    options: (O & CommonImportOptions & GraphChoiceOptions) | undefined,\n): Promise<ImportReport> {\n    const importAll = importer.importAll?.bind(importer);\n    if (importAll === undefined) {\n        return importer.import(input, sink, options);\n    }\n    const replay = await replayable(input);\n    const scratch: GraphBuilder[] = [];\n    await importAll(replay, (i) => (scratch[i] = new GraphBuilder({ directed: false })), {\n        ...options,\n        onProgress: undefined,\n    } as O & CommonImportOptions);\n    const names = scratch.map((b) => {\n        try {\n            return b.freeze().meta.name;\n        } catch {\n            return null;\n        }\n    });\n    const chosen = chooseGraph(names, options, new ImportReportBuilder(importer.format, 0));\n    const reports = await importAll(\n        replay,\n        (i) => (i === chosen ? sink : new GraphBuilder({ directed: false })),\n        options,\n    );\n    return reports[chosen];\n}\n\n/**\n * The input as a string or bytes that can be read twice.\n * @param input - the input\n * @returns the same text or bytes, or the stream's bytes\n */\nasync function replayable(input: ImportInput): Promise<string | Uint8Array> {\n    if (typeof input === \"string\" || input instanceof Uint8Array) {\n        return input;\n    }\n    const parts: Uint8Array[] = [];\n    const encoder = new TextEncoder();\n    if (typeof (input as ReadableStream<Uint8Array>).getReader === \"function\") {\n        const reader = (input as ReadableStream<Uint8Array>).getReader();\n        for (let r = await reader.read(); !r.done; r = await reader.read()) {\n            parts.push(r.value);\n        }\n    } else {\n        for await (const chunk of input as AsyncIterable<string | Uint8Array>) {\n            parts.push(typeof chunk === \"string\" ? encoder.encode(chunk) : chunk);\n        }\n    }\n    const out = new Uint8Array(parts.reduce((n, p) => n + p.byteLength, 0));\n    let offset = 0;\n    for (const part of parts) {\n        out.set(part, offset);\n        offset += part.byteLength;\n    }\n    return out;\n}\n"],"names":[],"mappings":";;;AA4BA,eAAsB,kBAClB,UACA,OACA,MACA,SACqB;AACrB,QAAM,YAAY,SAAS,WAAW,KAAK,QAAQ;AACnD,MAAI,cAAc,QAAW;AACzB,WAAO,SAAS,OAAO,OAAO,MAAM,OAAO;AAAA,EAC/C;AACA,QAAM,SAAS,MAAM,WAAW,KAAK;AACrC,QAAM,UAA0B,CAAA;AAChC,QAAM,UAAU,QAAQ,CAAC,MAAO,QAAQ,CAAC,IAAI,IAAI,aAAa,EAAE,UAAU,MAAA,CAAO,GAAI;AAAA,IACjF,GAAG;AAAA,IACH,YAAY;AAAA,EAAA,CACY;AAC5B,QAAM,QAAQ,QAAQ,IAAI,CAAC,MAAM;AAC7B,QAAI;AACA,aAAO,EAAE,SAAS,KAAK;AAAA,IAC3B,QAAQ;AACJ,aAAO;AAAA,IACX;AAAA,EACJ,CAAC;AACD,QAAM,SAAS,YAAY,OAAO,SAAS,IAAI,oBAAoB,SAAS,QAAQ,CAAC,CAAC;AACtF,QAAM,UAAU,MAAM;AAAA,IAClB;AAAA,IACA,CAAC,MAAO,MAAM,SAAS,OAAO,IAAI,aAAa,EAAE,UAAU,OAAO;AAAA,IAClE;AAAA,EAAA;AAEJ,SAAO,QAAQ,MAAM;AACzB;AAOA,eAAe,WAAW,OAAkD;AACxE,MAAI,OAAO,UAAU,YAAY,iBAAiB,YAAY;AAC1D,WAAO;AAAA,EACX;AACA,QAAM,QAAsB,CAAA;AAC5B,QAAM,UAAU,IAAI,YAAA;AACpB,MAAI,OAAQ,MAAqC,cAAc,YAAY;AACvE,UAAM,SAAU,MAAqC,UAAA;AACrD,aAAS,IAAI,MAAM,OAAO,KAAA,GAAQ,CAAC,EAAE,MAAM,IAAI,MAAM,OAAO,KAAA,GAAQ;AAChE,YAAM,KAAK,EAAE,KAAK;AAAA,IACtB;AAAA,EACJ,OAAO;AACH,qBAAiB,SAAS,OAA6C;AACnE,YAAM,KAAK,OAAO,UAAU,WAAW,QAAQ,OAAO,KAAK,IAAI,KAAK;AAAA,IACxE;AAAA,EACJ;AACA,QAAM,MAAM,IAAI,WAAW,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,YAAY,CAAC,CAAC;AACtE,MAAI,SAAS;AACb,aAAW,QAAQ,OAAO;AACtB,QAAI,IAAI,MAAM,MAAM;AACpB,cAAU,KAAK;AAAA,EACnB;AACA,SAAO;AACX;"}

package/dist/chunks/codes-CV_Bhcyi.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"codes-CV_Bhcyi.js","sources":["../../src/sources/cypher/descriptor.ts","../../src/sources/codes.ts"],"sourcesContent":["/**\n * The descriptors of the Cypher source and its presets: catalog data, available without loading\n * the sources' code.\n */\n\nimport { type SourceDescriptor, type SourceParamDescriptor } from \"../types.js\";\n\n/** The parameters every Cypher source shares. */\nconst CYPHER_PARAMS: readonly SourceParamDescriptor[] = [\n    { name: \"query\", plainName: \"Query\", type: \"query\", language: \"cypher\" },\n    {\n        name: \"mode\",\n        plainName: \"Mode\",\n        type: \"enum\",\n        values: [\n            { value: \"query\", label: \"Query\" },\n            { value: \"all\", label: \"Everything\" },\n            { value: \"neighborhood\", label: \"Neighborhood\" },\n        ],\n    },\n    { name: \"ids\", plainName: \"Seed ids\", type: \"node-id\" },\n    { name: \"depth\", plainName: \"Depth\", type: \"integer\", default: 1, min: 1, max: 10 },\n    { name: \"labels\", plainName: \"Labels\", type: \"string\", role: \"filter\", advanced: true },\n    { name: \"relationshipTypes\", plainName: \"Relationship types\", type: \"string\", role: \"filter\", advanced: true },\n    { name: \"idProperty\", plainName: \"Id property\", type: \"string\", advanced: true },\n    { name: \"database\", plainName: \"Database\", type: \"string\" },\n    {\n        name: \"long\",\n        plainName: \"Large integers\",\n        type: \"enum\",\n        advanced: true,\n        values: [\n            { value: \"f64\", label: \"Number\" },\n            { value: \"string\", label: \"Text\" },\n        ],\n    },\n    { name: \"countFirst\", plainName: \"Count first\", type: \"boolean\", advanced: true },\n    { name: \"pageSize\", plainName: \"Page size\", type: \"integer\", default: 1000, min: 1, max: 100000, advanced: true },\n];\n\n/** The transport parameter of the generic source. */\nconst TRANSPORT_PARAM: SourceParamDescriptor = {\n    name: \"transport\",\n    plainName: \"Transport\",\n    type: \"enum\",\n    values: [\n        { value: \"query-api\", label: \"Neo4j Query API\" },\n        { value: \"bolt\", label: \"Bolt\" },\n        { value: \"neptune-https\", label: \"Neptune Database\" },\n        { value: \"neptune-analytics\", label: \"Neptune Analytics\" },\n    ],\n};\n\n/**\n * The descriptor of the generic `cypher` source. Experimental.\n * @category Network sources\n */\nexport const CYPHER_DESCRIPTOR: SourceDescriptor = Object.freeze({\n    plainName: \"Cypher database\",\n    kind: \"database\",\n    version: 1,\n    auth: [\"basic\", \"bearer\", \"aws-sigv4\"],\n    authRequired: \"optional\",\n    params: [...CYPHER_PARAMS, TRANSPORT_PARAM],\n});\n\n/**\n * The descriptor of the `neo4j` preset. Experimental.\n * @category Network sources\n */\nexport const NEO4J_DESCRIPTOR: SourceDescriptor = Object.freeze({\n    plainName: \"Neo4j\",\n    kind: \"database\",\n    version: 1,\n    auth: [\"basic\", \"bearer\"],\n    authRequired: \"optional\",\n    params: [\n        ...CYPHER_PARAMS,\n        {\n            // no default: a bolt: or bolt+s: endpoint picks Bolt, any other the Query API\n            ...TRANSPORT_PARAM,\n            values: TRANSPORT_PARAM.values?.filter((v) => v.value === \"query-api\" || v.value === \"bolt\"),\n        },\n    ],\n    samples: [\n        {\n            id: \"neo4j-movies\",\n            plainName: \"Neo4j demo: movies\",\n            endpoint: \"https://demo.neo4jlabs.com:7473\",\n            params: { database: \"movies\", mode: \"all\" },\n            publicLogin: { username: \"movies\", password: \"movies\" }, // NOSONAR(S2068): the public login Neo4j publishes for its demo server\n            counts: { nodes: 171, edges: 253 },\n        },\n        {\n            id: \"hetionet\",\n            plainName: \"Hetionet\",\n            endpoint: \"bolt+s://neo4j.het.io:7687\",\n            params: { transport: \"bolt\", mode: \"neighborhood\", idProperty: \"name\", ids: [\"Metformin\"], depth: 1 },\n            counts: { nodes: 47031, edges: 2250197 },\n            whole: false,\n        },\n    ],\n});\n\n/**\n * The descriptor of the `neptune` preset. Experimental.\n * @category Network sources\n */\nexport const NEPTUNE_DESCRIPTOR: SourceDescriptor = Object.freeze({\n    plainName: \"Amazon Neptune\",\n    kind: \"database\",\n    version: 1,\n    auth: [\"aws-sigv4\"],\n    authRequired: \"optional\",\n    params: [\n        ...CYPHER_PARAMS,\n        {\n            // no default: a neptune-graph host picks Neptune Analytics, any other Neptune Database\n            ...TRANSPORT_PARAM,\n            values: TRANSPORT_PARAM.values?.filter((v) => v.value.startsWith(\"neptune\")),\n        },\n    ],\n    // Neptune sends no CORS headers (Database), or is not shown to (Analytics)\n    runtimes: { browser: { supported: false, reason: \"cors\" }, worker: { supported: false, reason: \"cors\" } },\n});\n","/**\n * The issue codes of network sources (design section 8). Every failure a source or the framework\n * raises is an ImportIssue with one of these codes and machine-readable `params`; graph-io writes\n * no reader-facing sentence. The English `message` is for logs.\n *\n * Experimental, with the source contract.\n */\n\nimport { FETCH_CODE } from \"../common/codes.js\";\n\n/**\n * Every issue code a network source can report, keyed by itself, so `SOURCE_ISSUE.E_SOURCE_AUTH`\n * autocompletes and `keyof typeof SOURCE_ISSUE` is the code union. Experimental.\n * @category Network sources\n */\nexport const SOURCE_ISSUE = Object.freeze({\n    /** Another HTTP status, or an unreachable host (Node). Params: `url`, `status`. */\n    E_FETCH: FETCH_CODE,\n    /** The browser refused the request and hid why. Params: `url`, `cause`. */\n    E_SOURCE_BLOCKED: \"E_SOURCE_BLOCKED\",\n    /** 401 or a database login failure. Params: `origin`, `status`, `scheme`, `serverCode`. */\n    E_SOURCE_AUTH: \"E_SOURCE_AUTH\",\n    /** 403 or a database authorization failure. Params: `status`, `serverCode`. */\n    E_SOURCE_FORBIDDEN: \"E_SOURCE_FORBIDDEN\",\n    /** The named item does not exist. Params: `what`, `value`. */\n    E_SOURCE_NOT_FOUND: \"E_SOURCE_NOT_FOUND\",\n    /** 429 after the retries. Params: `retryAfterMs`. */\n    E_SOURCE_QUOTA: \"E_SOURCE_QUOTA\",\n    /** `timeoutMs` passed, or the server's own timeout. Params: `timeoutMs`, `serverSide`. */\n    E_SOURCE_TIMEOUT: \"E_SOURCE_TIMEOUT\",\n    /** The server rejected the query. Params: `serverCode`, `line`, `column`, `serverMessage`. */\n    E_SOURCE_QUERY: \"E_SOURCE_QUERY\",\n    /** The result holds no node, relationship or path. Params: `columns`. */\n    E_SOURCE_NOT_A_GRAPH: \"E_SOURCE_NOT_A_GRAPH\",\n    /** A response body of the wrong shape. Params: `expected`, `contentType`. */\n    E_SOURCE_RESPONSE: \"E_SOURCE_RESPONSE\",\n    /** A redirect, or a changed origin, while a credential was attached. Params: `from`, `to`. */\n    E_SOURCE_REDIRECT: \"E_SOURCE_REDIRECT\",\n    /** The source cannot run in this runtime. Params: `runtime`, `reason`, `package`. */\n    E_SOURCE_RUNTIME: \"E_SOURCE_RUNTIME\",\n    /** A parameter or option is invalid. Params: `name`, `reason`. */\n    E_SOURCE_PARAM: \"E_SOURCE_PARAM\",\n    /** A cap was reached under `onLimit: \"error\"`. Params: `limit`, `value`. */\n    E_SOURCE_LIMIT: \"E_SOURCE_LIMIT\",\n    /** No source has that id. Params: `id`, `known`. */\n    E_SOURCE_UNKNOWN: \"E_SOURCE_UNKNOWN\",\n    /** The source lacks the feature. Params: `feature`, `needs`. */\n    E_SOURCE_UNSUPPORTED: \"E_SOURCE_UNSUPPORTED\",\n    /** A malformed source at registration. Params: `id`, `reason`. */\n    E_SOURCE_INVALID: \"E_SOURCE_INVALID\",\n    /** A cap stopped the load; what came first is kept. Params: `limit`, `value`. */\n    W_SOURCE_LIMIT: \"W_SOURCE_LIMIT\",\n    /** A later page needs a credential; the pages before it are kept. Params: `origin`, `status`. */\n    W_SOURCE_AUTH: \"W_SOURCE_AUTH\",\n    /** The request succeeded after retries. Params: `attempts`, `statuses`. */\n    W_SOURCE_RETRIED: \"W_SOURCE_RETRIED\",\n    /** A server value with no dtype. Params: `type`, `column`, `as`. */\n    W_SOURCE_VALUE: \"W_SOURCE_VALUE\",\n} as const);\n\n/**\n * A network source issue code. Experimental.\n * @category Network sources\n */\nexport type SourceIssueCode = keyof typeof SOURCE_ISSUE;\n\n/**\n * Why `E_SOURCE_BLOCKED` was raised, as far as a page can tell. Open: handle unknown values.\n * @category Network sources\n */\nexport type SourceBlockedCause = \"cors\" | \"unreachable\" | \"local-network\" | \"unknown\" | (string & {}); // NOSONAR(S4335): open string union, keeps the known names autocompleting\n\n/**\n * The `params` of each source issue code. Every URL is origin and path only. Experimental.\n * @category Network sources\n */\nexport interface SourceIssueParams {\n    /** Another status, or an unreachable host. */\n    readonly E_FETCH: {\n        /** The address, origin and path only. */\n        readonly url: string;\n        /** The HTTP status, or null when there was none. */\n        readonly status: number | null;\n    };\n    /** Refused by the browser. */\n    readonly E_SOURCE_BLOCKED: {\n        /** The address, origin and path only. */\n        readonly url: string;\n        /** Why, as far as the page can tell. */\n        readonly cause: SourceBlockedCause;\n    };\n    /** A credential is needed or was refused. */\n    readonly E_SOURCE_AUTH: {\n        /** The origin that asked for a credential. */\n        readonly origin: string;\n        /** The HTTP status, or null when there was none. */\n        readonly status: number | null;\n        /** The authentication scheme the server named, or null. */\n        readonly scheme: string | null;\n        /** The service's own code, passed through, or null. */\n        readonly serverCode: string | null;\n        /** Set by graphty-element when the credential came from its store. */\n        readonly stored?: boolean;\n    };\n    /** Not allowed. */\n    readonly E_SOURCE_FORBIDDEN: {\n        /** The HTTP status, or null when there was none. */\n        readonly status: number | null;\n        /** The service's own code, passed through, or null. */\n        readonly serverCode: string | null;\n    };\n    /** No such item. */\n    readonly E_SOURCE_NOT_FOUND: {\n        /** What was looked up (`url`, `network`, `node`). */\n        readonly what: string;\n        /** The value that reached the cap, or what was looked up. */\n        readonly value: string;\n    };\n    /** Out of quota. */\n    readonly E_SOURCE_QUOTA: {\n        /** How long the service asked to wait, when readable. */\n        readonly retryAfterMs: number | null;\n    };\n    /** Took too long. */\n    readonly E_SOURCE_TIMEOUT: {\n        /** The time limit, or null for the server's own. */\n        readonly timeoutMs: number | null;\n        /** Whether the server timed the query out. */\n        readonly serverSide: boolean;\n    };\n    /** The query was refused. */\n    readonly E_SOURCE_QUERY: {\n        /** The service's own code, passed through, or null. */\n        readonly serverCode: string | null;\n        /** The query line the server named, or null. */\n        readonly line: number | null;\n        /** The query column the server named, or null. */\n        readonly column: number | null;\n        /** The server's message from a JSON 4xx body, at most 500 characters, or null. */\n        readonly serverMessage: string | null;\n    };\n    /** Scalars only. */\n    readonly E_SOURCE_NOT_A_GRAPH: {\n        /** The result's column names. */\n        readonly columns: readonly string[];\n    };\n    /** Wrong body. */\n    readonly E_SOURCE_RESPONSE: {\n        /** What shape was expected (`json`, `graph-file`, `link-header`). */\n        readonly expected: string;\n        /** The response's Content-Type, or null. */\n        readonly contentType: string | null;\n    };\n    /** A redirect with a credential; `to` is null in a browser, which hides it. */\n    readonly E_SOURCE_REDIRECT: {\n        /** Where the request was going, origin and path. */\n        readonly from: string;\n        /** Where it was sent instead, or null when the browser hides it. */\n        readonly to: string | null;\n    };\n    /** Cannot run here. */\n    readonly E_SOURCE_RUNTIME: {\n        /** The runtime it ran in. */\n        readonly runtime: string;\n        /** Why, as a code. */\n        readonly reason: string;\n        /** The optional package that is missing. */\n        readonly package?: string;\n    };\n    /** A bad parameter or option. */\n    readonly E_SOURCE_PARAM: {\n        /** The parameter or option's name. */\n        readonly name: string;\n        /** Why, as a code. */\n        readonly reason: string;\n    };\n    /** A cap under onLimit \"error\". */\n    readonly E_SOURCE_LIMIT: {\n        /** The cap's option name (`maxNodes`, `maxBytes`, ...). */\n        readonly limit: string;\n        /** The value that reached the cap, or what was looked up. */\n        readonly value: number;\n    };\n    /** No such source. */\n    readonly E_SOURCE_UNKNOWN: {\n        /** The source id. */\n        readonly id: string;\n        /** The ids that are registered. */\n        readonly known: readonly string[];\n    };\n    /** The source lacks the feature. */\n    readonly E_SOURCE_UNSUPPORTED: {\n        /** The feature asked for. */\n        readonly feature: string;\n        /** What it needs, when known. */\n        readonly needs?: string;\n    };\n    /** A malformed source. */\n    readonly E_SOURCE_INVALID: {\n        /** The source id. */\n        readonly id: string;\n        /** Why, as a code. */\n        readonly reason: string;\n    };\n    /** A cap stopped the load. */\n    readonly W_SOURCE_LIMIT: {\n        /** The cap's option name (`maxNodes`, `maxBytes`, ...). */\n        readonly limit: string;\n        /** The value that reached the cap, or what was looked up. */\n        readonly value: number;\n    };\n    /** A later page needs a credential. */\n    readonly W_SOURCE_AUTH: {\n        /** The origin that asked for a credential. */\n        readonly origin: string;\n        /** The HTTP status, or null when there was none. */\n        readonly status: number | null;\n    };\n    /** Retried. */\n    readonly W_SOURCE_RETRIED: {\n        /** How many attempts were made. */\n        readonly attempts: number;\n        /** The status of each failed attempt, null for a network failure. */\n        readonly statuses: readonly (number | null)[];\n    };\n    /** A value with no dtype. */\n    readonly W_SOURCE_VALUE: {\n        /** The server's value type. */\n        readonly type: string;\n        /** The column (of the query, or of the graph) involved. */\n        readonly column: string;\n        /** What the value was kept as. */\n        readonly as: string;\n    };\n}\n"],"names":[],"mappings":"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"}

package/dist/chunks/convert-BcQ8_jMo.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"convert-BcQ8_jMo.js","sources":["../../src/positions/convert.ts"],"sourcesContent":["/**\n * The coordinate conversions between a file's spelling and the neutral convention (center, y up):\n * the y flip, the top-left anchor shift, and `toFilePositions()`, the inverse a writer uses. Format\n * modules import from here, so they never pull in the reader.\n */\n\nimport type { PositionColumnExtra } from \"./types.js\";\n\n/**\n * A y that grows downward as one that grows upward, and back: a negation that never yields -0.\n * @param y - the coordinate\n * @returns the flipped coordinate\n * @category Positions\n */\nexport function flipY(y: number): number {\n    return y === 0 ? 0 : -y;\n}\n\n/**\n * One coordinate from a file's spelling into the neutral convention, in place.\n * @param p - x, y, z as the file wrote them; becomes the node's center, y up\n * @param extra - how the file spells it\n * @param size - the node's width and height, for a top-left anchor; null when unknown\n * @param realZ - whether the file has a z that differs between nodes\n */\nexport function toNeutral(\n    p: [number, number, number],\n    extra: PositionColumnExtra,\n    size: readonly [number, number] | null,\n    realZ: boolean,\n): void {\n    if (extra.anchor === \"top-left\" && size !== null) {\n        p[0] += size[0] / 2;\n        p[1] += extra.yAxis === \"down\" ? size[1] / 2 : -size[1] / 2;\n    }\n    p[2] = realZ ? p[2] - (extra.zOrigin ?? 0) : 0;\n    if (extra.yAxis === \"down\") {\n        // with a real z this turns the drawing 180 degrees about x, so a 3D shape is never mirrored\n        p[1] = flipY(p[1]);\n        p[2] = flipY(p[2]);\n    }\n}\n\n/**\n * Neutral coordinates (center, y up, as `extractPositions()` returns them) back into a column\n * spelled as `extra` declares, for a writer: the y flip, Pajek's z origin and yEd's top-left corner\n * are undone. Rows that are NaN stay NaN.\n * @param coords - x, y, z per node\n * @param extra - the spelling of the column to write\n * @param sizes - each node's width and height, needed for a top-left anchor\n * @param sizes.width - widths by node index\n * @param sizes.height - heights by node index\n * @returns a new array, x, y, z per node in the file's spelling\n * @category Positions\n */\nexport function toFilePositions(\n    coords: Float64Array,\n    extra: PositionColumnExtra,\n    sizes?: { width: Float64Array; height: Float64Array },\n): Float64Array {\n    const out = new Float64Array(coords.length);\n    const down = extra.yAxis === \"down\";\n    for (let i = 0; i < coords.length; i += 3) {\n        let y = coords[i + 1];\n        let z = coords[i + 2];\n        if (down) {\n            y = flipY(y);\n            z = flipY(z);\n        }\n        out[i] = coords[i];\n        out[i + 1] = y;\n        out[i + 2] = z === 0 && extra.sourceDims !== 3 ? 0 : z + (extra.zOrigin ?? 0);\n        const row = i / 3;\n        if (extra.anchor === \"top-left\" && sizes !== undefined) {\n            out[i] -= sizes.width[row] / 2;\n            out[i + 1] -= down ? sizes.height[row] / 2 : -sizes.height[row] / 2;\n        }\n    }\n    return out;\n}\n\n/**\n * The median of some numbers.\n * @param values - the numbers, reordered in place\n * @returns the median, or null for none\n * @category Positions\n */\nexport function median(values: number[]): number | null {\n    if (values.length === 0) {\n        return null;\n    }\n    values.sort((a, b) => a - b);\n    const mid = values.length >> 1;\n    return values.length % 2 === 1 ? values[mid] : (values[mid - 1] + values[mid]) / 2;\n}\n\n/**\n * How each built-in writer that writes the position column as it stands spells a coordinate:\n * GML (y down, as yEd draws it) and Pajek (y down, z centered on 0.5). Every other built-in writer\n * either converts the neutral form itself (JSON, XGMML, CX, CX2, Cytoscape sessions, yEd graphics\n * in a styled GraphML) or writes a y-up format (GEXF, DOT).\n */\nconst WRITTEN_SPELLING: Readonly<Record<string, PositionColumnExtra>> = {\n    gml: { yAxis: \"down\" },\n    pajek: { yAxis: \"down\", zOrigin: 0.5 },\n};\n\n/**\n * Neutral coordinates (center, y up) as a built-in format's writer expects its position column, so\n * a graph whose positions are in the neutral form is written the way up its program draws it.\n * @example\n * ```ts\n * const column = writtenPositions(\"gml\", coords); // y flipped for GML\n * ```\n * @param format - the format being written\n * @param coords - x, y, z per node; NaN for a node with no position\n * @returns the coordinates to write (the same array when the format needs no conversion)\n * @category Positions\n */\nexport function writtenPositions(format: string, coords: Float64Array): Float64Array {\n    const spelling = WRITTEN_SPELLING[format];\n    return spelling === undefined ? coords : toFilePositions(coords, spelling);\n}\n"],"names":[],"mappings":"AAcO,SAAS,MAAM,GAAmB;AACrC,SAAO,MAAM,IAAI,IAAI,CAAC;AAC1B;AASO,SAAS,UACZ,GACA,OACA,MACA,OACI;AACJ,MAAI,MAAM,WAAW,cAAc,SAAS,MAAM;AAC9C,MAAE,CAAC,KAAK,KAAK,CAAC,IAAI;AAClB,MAAE,CAAC,KAAK,MAAM,UAAU,SAAS,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI;AAAA,EAC9D;AACA,IAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,KAAK,MAAM,WAAW,KAAK;AAC7C,MAAI,MAAM,UAAU,QAAQ;AAExB,MAAE,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;AACjB,MAAE,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;AAAA,EACrB;AACJ;AAcO,SAAS,gBACZ,QACA,OACA,OACY;AACZ,QAAM,MAAM,IAAI,aAAa,OAAO,MAAM;AAC1C,QAAM,OAAO,MAAM,UAAU;AAC7B,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACvC,QAAI,IAAI,OAAO,IAAI,CAAC;AACpB,QAAI,IAAI,OAAO,IAAI,CAAC;AACpB,QAAI,MAAM;AACN,UAAI,MAAM,CAAC;AACX,UAAI,MAAM,CAAC;AAAA,IACf;AACA,QAAI,CAAC,IAAI,OAAO,CAAC;AACjB,QAAI,IAAI,CAAC,IAAI;AACb,QAAI,IAAI,CAAC,IAAI,MAAM,KAAK,MAAM,eAAe,IAAI,IAAI,KAAK,MAAM,WAAW;AAC3E,UAAM,MAAM,IAAI;AAChB,QAAI,MAAM,WAAW,cAAc,UAAU,QAAW;AACpD,UAAI,CAAC,KAAK,MAAM,MAAM,GAAG,IAAI;AAC7B,UAAI,IAAI,CAAC,KAAK,OAAO,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,MAAM,OAAO,GAAG,IAAI;AAAA,IACtE;AAAA,EACJ;AACA,SAAO;AACX;AAQO,SAAS,OAAO,QAAiC;AACpD,MAAI,OAAO,WAAW,GAAG;AACrB,WAAO;AAAA,EACX;AACA,SAAO,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AAC3B,QAAM,MAAM,OAAO,UAAU;AAC7B,SAAO,OAAO,SAAS,MAAM,IAAI,OAAO,GAAG,KAAK,OAAO,MAAM,CAAC,IAAI,OAAO,GAAG,KAAK;AACrF;AAQA,MAAM,mBAAkE;AAAA,EACpE,KAAK,EAAE,OAAO,OAAA;AAAA,EACd,OAAO,EAAE,OAAO,QAAQ,SAAS,IAAA;AACrC;AAcO,SAAS,iBAAiB,QAAgB,QAAoC;AACjF,QAAM,WAAW,iBAAiB,MAAM;AACxC,SAAO,aAAa,SAAY,SAAS,gBAAgB,QAAQ,QAAQ;AAC7E;"}

package/dist/chunks/credentials-BiQsnMTb.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"credentials-BiQsnMTb.js","sources":["../../src/sources/ids.ts","../../src/sources/fail.ts","../../src/sources/define.ts","../../src/sources/credentials.ts"],"sourcesContent":["/**\n * The public names of network sources: one constant per built-in source id, and the reserved\n * `_source.` attribute names. Nothing else in graph-io spells them, so a rename is one edit here.\n *\n * Experimental: the ids and the `_source.` namespace await the owner's final word (design\n * section 22, items 4 and 5).\n */\n\n/**\n * The NDEx source (www.ndexbio.org). Experimental.\n * @category Network sources\n */\nexport const NDEX_SOURCE_ID = \"ndex\";\n\n/**\n * The generic Cypher source, for any openCypher server. Experimental.\n * @category Network sources\n */\nexport const CYPHER_SOURCE_ID = \"cypher\";\n\n/**\n * The Neo4j preset of the Cypher source. Experimental.\n * @category Network sources\n */\nexport const NEO4J_SOURCE_ID = \"neo4j\";\n\n/**\n * The Amazon Neptune preset of the Cypher source. Experimental.\n * @category Network sources\n */\nexport const NEPTUNE_SOURCE_ID = \"neptune\";\n\n/**\n * The generic REST mapping source. Experimental.\n * @category Network sources\n */\nexport const REST_SOURCE_ID = \"rest\";\n\n/**\n * The OpenAlex preset of the REST mapping source. Experimental.\n * @category Network sources\n */\nexport const OPENALEX_SOURCE_ID = \"openalex\";\n\n/**\n * The prefix of the reserved attribute namespace sources and graphty-element write facts under.\n * @category Network sources\n */\nexport const SOURCE_ATTR_PREFIX = \"_source.\";\n\n/**\n * Node attribute: true on a stub, a node known only by its id until it is hydrated or expanded.\n * @category Network sources\n */\nexport const SOURCE_STUB_ATTR = \"_source.stub\";\n\n/**\n * Node attribute: the entity a stub node is (a REST mapping's entity name).\n * @category Network sources\n */\nexport const SOURCE_ENTITY_ATTR = \"_source.entity\";\n\n/**\n * Node attribute: the node's degree at the source, when the source returns it at no extra cost\n * (the Cypher source's degree hint).\n * @category Network sources\n */\nexport const SOURCE_DEGREE_ATTR = \"_source.degree\";\n\n/**\n * The prefix of `ImportGraphResult.format` for a load from a source: `\"source:<id>\"`.\n * @category Network sources\n */\nexport const SOURCE_FORMAT_PREFIX = \"source:\";\n","/**\n * Raising a network source issue: one place that turns a code and its params into an ImportError\n * whose `issue.params` and `details` both carry the params, so callers branch on\n * `err.issue.code` and read `err.issue.params` as with every other graph-io failure.\n */\n\nimport { ImportReportBuilder } from \"../common/report.js\";\nimport { type IssueCategory } from \"../types.js\";\nimport { type SourceIssueCode } from \"./codes.js\";\n\n/** The category each code is filed under. */\nconst CATEGORY: Readonly<Partial<Record<SourceIssueCode, IssueCategory>>> = {\n    E_SOURCE_PARAM: \"validation-error\",\n    E_SOURCE_INVALID: \"validation-error\",\n    E_SOURCE_RESPONSE: \"parse-error\",\n    E_SOURCE_NOT_A_GRAPH: \"parse-error\",\n    E_SOURCE_NOT_FOUND: \"missing-value\",\n    E_SOURCE_UNKNOWN: \"missing-value\",\n};\n\n/**\n * Abort a load with a source error, carrying the load's report so far plus the error.\n * @param report - the load's report\n * @param code - the code\n * @param message - a plain-ASCII message, for logs\n * @param params - the issue's values\n * @returns never; it throws the ImportError\n */\nexport function failOn(\n    report: ImportReportBuilder,\n    code: SourceIssueCode,\n    message: string,\n    params: Readonly<Record<string, unknown>>,\n): never {\n    // a fork, so a failure the runner turns into a warning (a later page's 401, a cap) leaves no\n    // error in the load's own report; the ImportError carries everything recorded so far\n    return report.fork().failWith(CATEGORY[code] ?? \"unsupported\", code, message, undefined, params, params);\n}\n\n/**\n * Raise a source error outside a load (registration, a credential factory).\n * @param code - the code\n * @param message - a plain-ASCII message, for logs\n * @param params - the issue's values\n * @param format - the report's format name\n */\nexport function failAlone(\n    code: SourceIssueCode,\n    message: string,\n    params: Readonly<Record<string, unknown>>,\n    format = \"source\",\n): never {\n    failOn(new ImportReportBuilder(format, 0), code, message, params);\n}\n\n/**\n * Record a source warning on a report.\n * @param report - the report\n * @param code - the code\n * @param message - a plain-ASCII message, for logs\n * @param params - the issue's values\n */\nexport function warnOn(\n    report: ImportReportBuilder,\n    code: SourceIssueCode,\n    message: string,\n    params: Readonly<Record<string, unknown>>,\n): void {\n    report.warning(\"unsupported\", code, message, undefined, params);\n}\n","/**\n * `defineSource` and the registration checks (design section 2): the id form, exactly one read\n * method, and the declared features against the methods present. Also the parameter checks every\n * load runs against the descriptor before any request.\n */\n\nimport { type ImportReportBuilder } from \"../common/report.js\";\nimport { failAlone, failOn } from \"./fail.js\";\nimport {\n    type GraphSource,\n    type LazySource,\n    type SourceDescriptor,\n    type SourceFeature,\n    type SourceParamDescriptor,\n} from \"./types.js\";\n\n/** Lowercase letters, digits and single dashes between them. */\nconst ID_FORM = /^[a-z0-9]+(-[a-z0-9]+)*$/;\n\n/** The optional methods and the feature each one is. */\nconst FEATURE_METHODS: readonly (readonly [SourceFeature, \"expand\" | \"probe\" | \"list\" | \"validate\"])[] = [\n    [\"expand\", \"expand\"],\n    [\"probe\", \"probe\"],\n    [\"list\", \"list\"],\n    [\"validate\", \"validate\"],\n];\n\n/**\n * Refuse a malformed source.\n * @param id - the source id\n * @param reason - why\n * @param message - for logs\n */\nfunction invalid(id: string, reason: string, message: string): never {\n    failAlone(\"E_SOURCE_INVALID\", message, { id, reason });\n}\n\n/**\n * Check a source id.\n * @param id - the id\n */\nfunction checkSourceId(id: unknown): asserts id is string {\n    if (typeof id !== \"string\" || !ID_FORM.test(id)) {\n        invalid(String(id), \"id\", `source id ${JSON.stringify(id)} must be lowercase letters, digits and dashes`);\n    }\n}\n\n/**\n * The features a loaded source has, from its methods.\n * @param source - the source\n * @returns the features\n */\nfunction featuresOf(source: GraphSource<never>): readonly SourceFeature[] {\n    return FEATURE_METHODS.filter(([, method]) => typeof source[method] === \"function\").map(([f]) => f);\n}\n\n/**\n * Check a loaded source: its id, exactly one read method, and its declared features.\n * @param source - the source\n * @param declared - features a lazy registration declared, if any\n */\nexport function checkSource(source: GraphSource<never>, declared?: SourceDescriptor): void {\n    checkSourceId((source as { id?: unknown }).id);\n    const reads = ([\"records\", \"file\", \"import\"] as const).filter((m) => typeof source[m] === \"function\");\n    if (reads.length !== 1) {\n        invalid(source.id, \"read-methods\", `source ${source.id} must have exactly one of records, file and import`);\n    }\n    const features = (declared ?? source.descriptor)?.features;\n    if (features !== undefined) {\n        const has = new Set(featuresOf(source));\n        for (const f of features) {\n            if (f !== \"page\" && !has.has(f)) {\n                invalid(source.id, \"features\", `source ${source.id} declares ${f} but has no ${f} method`);\n            }\n        }\n    }\n}\n\n/**\n * Check a lazy registration before its code is loaded.\n * @param source - the lazy source\n */\nexport function checkLazySource(source: LazySource): void {\n    checkSourceId(source.id);\n    if (typeof source.load !== \"function\" || typeof source.descriptor !== \"object\") {\n        invalid(source.id, \"lazy\", `lazy source ${source.id} needs a descriptor and a load function`);\n    }\n}\n\n/**\n * Define a network source: returns it unchanged, with its parameter type inferred, after the\n * registration checks (an id of lowercase letters, digits and dashes; exactly one of `records`,\n * `file` and `import`; declared features backed by methods). A malformed source throws an\n * ImportError whose `issue.code` is E_SOURCE_INVALID. Experimental.\n * @param source - the source\n * @returns the same source\n * @example\n * ```ts\n * const people = defineSource({\n *     id: \"people\",\n *     async records(params: { team: string }, ctx) {\n *         const rows = await ctx.fetchJson<{ id: string; name: string }[]>(`/api/people?team=${params.team}`);\n *         return { nodes: rows };\n *     },\n * });\n * ```\n * @category Network sources\n */\nexport function defineSource<P>(source: GraphSource<P>): GraphSource<P> {\n    checkSource(source);\n    return source;\n}\n\n/**\n * Why a number or integer param is wrong, if it is.\n * @param p - the param's descriptor\n * @param value - the value given\n * @returns the reason, or null when it is fine\n */\nfunction numberProblem(p: SourceParamDescriptor, value: unknown): string | null {\n    if (typeof value !== \"number\" || Number.isNaN(value) || (p.type === \"integer\" && !Number.isInteger(value))) {\n        return \"type\";\n    }\n    if ((p.min !== undefined && value < p.min) || (p.max !== undefined && value > p.max)) {\n        return \"range\";\n    }\n    return null;\n}\n\n/**\n * Why a URL param is wrong, if it is.\n * @param value - the value given\n * @returns the reason, or null when it is fine\n */\nfunction urlProblem(value: unknown): string | null {\n    let url: URL;\n    try {\n        url = new URL(typeof value === \"string\" ? value : \"\");\n    } catch {\n        return \"type\";\n    }\n    return url.username !== \"\" || url.password !== \"\" ? \"credentials-in-url\" : null;\n}\n\n/**\n * Why a present param value is wrong for its descriptor, if it is.\n * @param p - the param's descriptor\n * @param value - the value given (not undefined or null)\n * @returns the reason, or null when it is fine\n */\nfunction paramProblem(p: SourceParamDescriptor, value: unknown): string | null {\n    switch (p.type) {\n        case \"integer\":\n        case \"number\":\n            return numberProblem(p, value);\n        case \"boolean\":\n            return typeof value === \"boolean\" ? null : \"type\";\n        case \"enum\":\n            return p.values !== undefined && !p.values.some((v) => v.value === value) ? \"enum\" : null;\n        case \"url\":\n            return urlProblem(value);\n        default:\n            return null;\n    }\n}\n\n/**\n * Check params against a descriptor before any request: required ones present, numbers and\n * integers in range, booleans, enums, URLs (never with a user name or password in them).\n * @param params - the caller's params\n * @param descriptor - the source's descriptor\n * @param report - the load's report\n */\nexport function checkParams(\n    params: Readonly<Record<string, unknown>>,\n    descriptor: SourceDescriptor | undefined,\n    report: ImportReportBuilder,\n): void {\n    if (typeof params !== \"object\" || (params as unknown) === null) {\n        failOn(report, \"E_SOURCE_PARAM\", \"params must be an object\", { name: \"params\", reason: \"type\" });\n    }\n    for (const p of descriptor?.params ?? []) {\n        const value = params[p.name];\n        const missing = value === undefined || value === null;\n        let reason: string | null = null;\n        if (!missing) {\n            reason = paramProblem(p, value);\n        } else if (p.required === true && p.default === undefined) {\n            reason = \"required\";\n        }\n        if (reason !== null) {\n            failOn(report, \"E_SOURCE_PARAM\", `parameter ${p.name}: ${reason}`, { name: p.name, reason });\n        }\n    }\n}\n","/**\n * Credentials (design section 6): objects made by factories, holding their secret where no code\n * can read it back. graph-io applies a credential inside `ctx.fetch`, only to the origins it is\n * bound to, and keeps nothing after a load settles.\n *\n * Experimental, with the source contract.\n */\n\nimport { failAlone } from \"./fail.js\";\nimport { type AwsCredentials, type Credential, type CredentialKind } from \"./types.js\";\n\n/**\n * Where a credential may go: the load's endpoint origin by default. Experimental.\n * @category Network sources\n */\nexport interface CredentialBind {\n    /** The origins (scheme, host and port) it may be sent to. */\n    readonly origins?: readonly string[] | undefined;\n}\n\n/**\n * The options of `credentials.awsSigV4`. Experimental.\n * @category Network sources\n */\nexport interface AwsSigV4Options {\n    /** The AWS region (\"us-east-1\"). */\n    readonly region: string;\n    /** The signing service: \"neptune-db\" (default) or \"neptune-graph\" for Neptune Analytics. */\n    readonly service?: string | undefined;\n    /** The credentials, or a function returning fresh ones per request. */\n    readonly credentials: AwsCredentials | (() => Promise<AwsCredentials>);\n}\n\n/** What only graph-io's own code can read about a credential. */\ntype Secret =\n    | { readonly kind: \"bearer\"; readonly token: string | (() => Promise<string>) }\n    | { readonly kind: \"basic\"; readonly username: string; readonly password: string }\n    | {\n          readonly kind: \"api-key\";\n          readonly header: string | null;\n          readonly query: string | null;\n          readonly value: string;\n      }\n    | { readonly kind: \"aws-sigv4\"; readonly options: AwsSigV4Options }\n    | {\n          readonly kind: \"custom\";\n          readonly name: string;\n          readonly apply: (request: Request) => Promise<Request> | Request;\n      };\n\n/** The secrets, by credential; a WeakMap so nothing reachable from the object holds them. */\nconst SECRETS = new WeakMap<Credential, Secret>();\n\n/** The key Node's util.inspect looks up. */\nconst INSPECT = Symbol.for(\"nodejs.util.inspect.custom\");\n\n/**\n * The scheme, host and port of a URL. `URL.origin` is \"null\" for schemes such as bolt+s:, so this\n * is used everywhere instead.\n * @param url - the URL\n * @returns the origin string\n */\nexport function originOf(url: URL): string {\n    return `${url.protocol}//${url.host}`;\n}\n\n/**\n * Normalize the origins a credential is bound to.\n * @param bind - the bind option\n * @returns the normalized origins\n */\nfunction bindOrigins(bind: CredentialBind | undefined): readonly string[] {\n    return Object.freeze(\n        (bind?.origins ?? []).map((o) => {\n            let url: URL;\n            try {\n                url = new URL(o);\n            } catch {\n                return failAlone(\"E_SOURCE_PARAM\", `credential origin ${JSON.stringify(o)} is not a URL`, {\n                    name: \"origins\",\n                    reason: \"origin\",\n                });\n            }\n            return originOf(url);\n        }),\n    );\n}\n\n/** The object every factory returns: kind and origins visible, the secret in SECRETS. */\nclass SourceCredential implements Credential {\n    readonly kind: CredentialKind;\n    readonly origins: readonly string[];\n    readonly username: string | undefined;\n\n    /**\n     * Create one; only the factories do.\n     * @param secret - the secret\n     * @param bind - the origins it is bound to\n     */\n    constructor(secret: Secret, bind: CredentialBind | undefined) {\n        this.kind = secret.kind === \"custom\" ? secret.name : secret.kind;\n        this.origins = bindOrigins(bind);\n        this.username = secret.kind === \"basic\" ? secret.username : undefined;\n        SECRETS.set(this, secret);\n        Object.freeze(this);\n    }\n\n    /**\n     * What JSON.stringify writes: never the secret.\n     * @returns kind, origins and a basic credential's user name\n     */\n    toJSON(): Record<string, unknown> {\n        return this.username === undefined\n            ? { kind: this.kind, origins: this.origins }\n            : { kind: this.kind, origins: this.origins, username: this.username };\n    }\n\n    /**\n     * What util.inspect and console.log show in Node: never the secret.\n     * @returns the same as toJSON\n     */\n    [INSPECT](): Record<string, unknown> {\n        return this.toJSON();\n    }\n\n    /**\n     * What string conversion shows: never the secret.\n     * @returns a description\n     */\n    toString(): string {\n        return `[Credential ${this.kind}]`;\n    }\n}\n\n/**\n * Base64 of a string's UTF-8 bytes.\n * @param text - the text\n * @returns base64\n */\nfunction base64(text: string): string {\n    let binary = \"\";\n    for (const b of new TextEncoder().encode(text)) {\n        binary += String.fromCodePoint(b);\n    }\n    return btoa(binary);\n}\n\n/**\n * The factories that make credentials. Pass the result as the `credential` option of a load; it is\n * sent only to the load's endpoint origin, or to `bind.origins` when you give them. Experimental.\n * @example\n * ```ts\n * await loadFromSource(\"people\", { team: \"core\" }, {\n *     endpoint: \"https://example.com\",\n *     credential: credentials.bearer(token),\n * });\n * ```\n * @category Network sources\n */\nexport const credentials = Object.freeze({\n    /**\n     * An `Authorization: Bearer` token, or a function returning a fresh one per request.\n     * @param token - the token or a function returning it\n     * @param bind - the origins it may be sent to\n     * @returns the credential\n     */\n    bearer(token: string | (() => Promise<string>), bind?: CredentialBind): Credential {\n        return new SourceCredential({ kind: \"bearer\", token }, bind);\n    },\n    /**\n     * HTTP basic authentication (a database user and password).\n     * @param username - the user name\n     * @param password - the password\n     * @param bind - the origins it may be sent to\n     * @returns the credential\n     */\n    basic(username: string, password: string, bind?: CredentialBind): Credential {\n        return new SourceCredential({ kind: \"basic\", username, password }, bind);\n    },\n    /**\n     * An API key sent in a request header or a query parameter.\n     * @param where - `{ header: \"X-Api-Key\" }` or `{ query: \"api_key\" }`\n     * @param value - the key\n     * @param bind - the origins it may be sent to\n     * @returns the credential\n     */\n    apiKey(\n        where: { readonly header: string } | { readonly query: string },\n        value: string,\n        bind?: CredentialBind,\n    ): Credential {\n        const header = \"header\" in where ? where.header : null;\n        const query = \"query\" in where ? where.query : null;\n        return new SourceCredential({ kind: \"api-key\", header, query, value }, bind);\n    },\n    /**\n     * AWS Signature Version 4 (Amazon Neptune). The signer loads on first use.\n     * @param options - region, service and the credentials or a provider of them\n     * @param bind - the origins it may be sent to\n     * @returns the credential\n     */\n    awsSigV4(options: AwsSigV4Options, bind?: CredentialBind): Credential {\n        return new SourceCredential({ kind: \"aws-sigv4\", options }, bind);\n    },\n    /**\n     * Anything else: a function that returns the request with its authentication added. The\n     * request's origin must not change.\n     * @param apply - adds the authentication\n     * @param kind - what to call it in `credential.kind`\n     * @param bind - the origins it may be sent to\n     * @returns the credential\n     */\n    custom(apply: (request: Request) => Promise<Request> | Request, kind: string, bind?: CredentialBind): Credential {\n        return new SourceCredential({ kind: \"custom\", name: kind, apply }, bind);\n    },\n});\n\n/**\n * The secret of a credential made by the factories, or undefined for any other object.\n * @param credential - the credential\n * @returns the secret\n */\nfunction secretOf(credential: Credential): Secret | undefined {\n    return SECRETS.get(credential);\n}\n\n/**\n * Whether an object is a credential made by the `credentials` factories.\n * @param value - the value\n * @returns true for a factory-made credential\n */\nexport function isCredential(value: unknown): value is Credential {\n    return typeof value === \"object\" && value !== null && secretOf(value as Credential) !== undefined;\n}\n\n/**\n * The request header a credential sets, for the browser checks; null for a query key or a custom one.\n * @param credential - the credential\n * @returns the header name, lowercase\n */\nexport function credentialHeader(credential: Credential): string | null {\n    const secret = secretOf(credential);\n    if (secret?.kind === \"api-key\") {\n        return secret.header?.toLowerCase() ?? null;\n    }\n    return secret?.kind === \"bearer\" || secret?.kind === \"basic\" || secret?.kind === \"aws-sigv4\"\n        ? \"authorization\"\n        : null;\n}\n\n/**\n * Add a credential to a request. Internal to graph-io: only `ctx.fetch` calls it.\n * @param credential - the credential\n * @param request - the request\n * @returns the request with its authentication\n */\nexport async function applyCredential(credential: Credential, request: Request): Promise<Request> {\n    const secret = secretOf(credential);\n    if (secret === undefined) {\n        return failAlone(\"E_SOURCE_PARAM\", \"the credential was not made by the credentials factories\", {\n            name: \"credential\",\n            reason: \"type\",\n        });\n    }\n    switch (secret.kind) {\n        case \"bearer\": {\n            const token = typeof secret.token === \"string\" ? secret.token : await secret.token();\n            const headers = new Headers(request.headers);\n            headers.set(\"Authorization\", `Bearer ${token}`);\n            return new Request(request, { headers });\n        }\n        case \"basic\": {\n            const headers = new Headers(request.headers);\n            const pair = `${secret.username}:${secret.password}`;\n            headers.set(\"Authorization\", `Basic ${base64(pair)}`);\n            return new Request(request, { headers });\n        }\n        case \"api-key\": {\n            if (secret.header !== null) {\n                const headers = new Headers(request.headers);\n                headers.set(secret.header, secret.value);\n                return new Request(request, { headers });\n            }\n            const url = new URL(request.url);\n            url.searchParams.set(secret.query ?? \"api_key\", secret.value);\n            return new Request(url, request);\n        }\n        case \"aws-sigv4\": {\n            const { signRequest } = await import(\"./sigv4.js\");\n            return signRequest(request, secret.options);\n        }\n        case \"custom\":\n            return secret.apply(request);\n        default:\n            return request;\n    }\n}\n\n/**\n * The raw secret, for a transport that must hand it to a driver (Bolt). Internal to graph-io; the\n * caller applies the origin and TLS rules itself.\n * @param credential - the credential\n * @returns the kind and the values the driver needs\n */\nexport function unwrapCredential(\n    credential: Credential,\n):\n    | { readonly kind: \"basic\"; readonly username: string; readonly password: string }\n    | { readonly kind: \"bearer\"; readonly token: string | (() => Promise<string>) }\n    | { readonly kind: CredentialKind }\n    | undefined {\n    const secret = secretOf(credential);\n    if (secret?.kind === \"basic\") {\n        return { kind: \"basic\", username: secret.username, password: secret.password };\n    }\n    if (secret?.kind === \"bearer\") {\n        return { kind: \"bearer\", token: secret.token };\n    }\n    return secret === undefined ? undefined : { kind: credential.kind };\n}\n\n/**\n * Whether a credential can be remembered: its secret is a plain value, not a function. A token\n * refresher, a custom credential and an AWS provider cannot.\n * @param credential - the credential\n * @returns true for basic, a bearer string token and an API key\n */\nexport function isStorableCredential(credential: Credential): boolean {\n    const secret = secretOf(credential);\n    return (\n        secret?.kind === \"basic\" ||\n        secret?.kind === \"api-key\" ||\n        (secret?.kind === \"bearer\" && typeof secret.token === \"string\")\n    );\n}\n\n/**\n * The plain parts of a credential that can be remembered. Experimental.\n * @category Network sources\n */\nexport type StorableCredential =\n    | {\n          /** A user name and password, sent as HTTP Basic authentication. */\n          readonly kind: \"basic\";\n          /** The user name. */\n          readonly username: string;\n          /** The password. */\n          readonly password: string;\n      }\n    | {\n          /** A bearer token, sent in the Authorization header. */\n          readonly kind: \"bearer\";\n          /** The token. */\n          readonly token: string;\n      }\n    | {\n          /** An API key, sent in a header or a query parameter. */\n          readonly kind: \"api-key\";\n          /** The header that carries the key, or null when a query parameter does. */\n          readonly header: string | null;\n          /** The query parameter that carries the key, or null when a header does. */\n          readonly query: string | null;\n          /** The key. */\n          readonly value: string;\n      };\n\n/**\n * The parts of a credential a credential store saves (graphty-element's `CredentialStore` is the\n * one caller), or null when it cannot be saved: a token function, an AWS provider or a custom\n * credential. The result HOLDS THE SECRET: never log it, and keep it only where you would keep the\n * password itself. `fromStorableCredential` makes the credential again. Experimental.\n * @param credential - a credential made by the `credentials` factories\n * @returns the parts, or null\n * @category Network sources\n */\nexport function storableCredential(credential: Credential): StorableCredential | null {\n    const secret = secretOf(credential);\n    switch (secret?.kind) {\n        case \"basic\":\n            return { kind: \"basic\", username: secret.username, password: secret.password };\n        case \"api-key\":\n            return { kind: \"api-key\", header: secret.header, query: secret.query, value: secret.value };\n        case \"bearer\":\n            return typeof secret.token === \"string\" ? { kind: \"bearer\", token: secret.token } : null;\n        default:\n            return null;\n    }\n}\n\n/**\n * The credential `storableCredential` took apart, bound to the origins given. Experimental.\n * @param parts - what `storableCredential` returned\n * @param bind - the origins it may be sent to\n * @returns the credential\n * @category Network sources\n */\nexport function fromStorableCredential(parts: StorableCredential, bind?: CredentialBind): Credential {\n    switch (parts.kind) {\n        case \"basic\":\n            return credentials.basic(parts.username, parts.password, bind);\n        case \"bearer\":\n            return credentials.bearer(parts.token, bind);\n        default:\n            return new SourceCredential(\n                { kind: \"api-key\", header: parts.header, query: parts.query, value: parts.value },\n                bind,\n            );\n    }\n}\n"],"names":[],"mappings":"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"}

package/dist/chunks/descriptor-BJ-W0Jd-.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"descriptor-BJ-W0Jd-.js","sources":["../../src/sources/rest/samples/deps-dev.ts","../../src/sources/rest/samples/string.ts","../../src/sources/rest/descriptor.ts"],"sourcesContent":["/**\n * A sample mapping: the resolved dependency graph of one package version from deps.dev\n * (https://deps.dev). The body already holds a node array and an edge array whose ends are node\n * positions, so the body is a container and `#` gives each package its position as its id.\n * Catalog data for the `rest` source's samples.\n */\n\nimport { type RestMapping } from \"../params.js\";\n\n/** The deps.dev dependencies mapping: `system` (npm, pypi, ...), `package` and `version`. */\nexport const DEPS_DEV_MAPPING: RestMapping = Object.freeze<RestMapping>({\n    version: 1,\n    endpoint: \"https://api.deps.dev\",\n    load: \"dependencies\",\n    directed: true,\n    requests: {\n        dependencies: {\n            path: \"/v3/systems/{system}/packages/{package}/versions/{version}:dependencies\",\n            records: \".\",\n            entity: \"graph\",\n        },\n    },\n    entities: {\n        graph: {\n            id: \"nodes\",\n            node: false,\n            edges: [\n                {\n                    each: \"edges[]\",\n                    from: \"fromNode\",\n                    to: \"toNode\",\n                    type: \"depends_on\",\n                    entity: \"package\",\n                    fields: { requirement: \"requirement\" },\n                },\n            ],\n            embedded: [{ at: \"nodes[]\", entity: \"package\" }],\n        },\n        package: {\n            id: \"#\",\n            fields: {\n                name: \"versionKey.name\",\n                version: \"versionKey.version\",\n                system: \"versionKey.system\",\n                relation: \"relation\",\n            },\n        },\n    },\n});\n","/**\n * A sample mapping: STRING's functional partners of a protein (https://string-db.org). Each\n * interaction record names both proteins, so both are embedded nodes and the record itself is only\n * the edge. Catalog data for the `rest` source's samples.\n */\n\nimport { type RestMapping } from \"../params.js\";\n\n/** The STRING network mapping: `identifiers`, `species` (NCBI taxon) and `add_nodes`. */\nexport const STRING_MAPPING: RestMapping = Object.freeze<RestMapping>({\n    version: 1,\n    endpoint: \"https://string-db.org\",\n    load: \"network\",\n    directed: false,\n    requests: {\n        network: {\n            path: \"/api/json/network\",\n            query: { identifiers: \"{identifiers}\", species: \"{species}\", add_nodes: \"{add_nodes}\" },\n            records: \".\",\n            entity: \"interaction\",\n        },\n    },\n    entities: {\n        interaction: {\n            id: \"stringId_A\",\n            node: false,\n            edges: [\n                {\n                    from: \"stringId_A\",\n                    to: \"stringId_B\",\n                    type: \"interacts_with\",\n                    entity: \"protein-b\",\n                    fields: { score: \"score\" },\n                },\n            ],\n            embedded: [\n                { at: \".\", entity: \"protein-a\" },\n                { at: \".\", entity: \"protein-b\" },\n            ],\n        },\n        \"protein-a\": { id: \"stringId_A\", label: \"protein\", fields: { name: \"preferredName_A\" } },\n        \"protein-b\": { id: \"stringId_B\", label: \"protein\", fields: { name: \"preferredName_B\" } },\n    },\n});\n","/**\n * The descriptors of the REST mapping source and its `openalex` preset: catalog data, available\n * without loading the sources' code.\n */\n\nimport { type SourceDescriptor } from \"../types.js\";\nimport { DEPS_DEV_MAPPING } from \"./samples/deps-dev.js\";\nimport { STRING_MAPPING } from \"./samples/string.js\";\n\n/**\n * The descriptor of the generic `rest` source. Experimental.\n * @category Network sources\n */\nexport const REST_DESCRIPTOR: SourceDescriptor = Object.freeze({\n    plainName: \"REST API\",\n    kind: \"rest\",\n    version: 1,\n    auth: [\"bearer\", \"api-key\"],\n    authRequired: \"optional\",\n    params: [{ name: \"mapping\", plainName: \"Mapping\", type: \"text\", required: true }],\n    samples: [\n        {\n            id: \"string-tp53\",\n            plainName: \"STRING: TP53's functional partners\",\n            params: { mapping: STRING_MAPPING, identifiers: \"TP53\", species: \"9606\", add_nodes: \"20\" },\n            endpoint: STRING_MAPPING.endpoint,\n            counts: { nodes: 21, edges: 113 },\n        },\n        {\n            id: \"deps-dev-webpack\",\n            plainName: \"deps.dev: webpack 5.90.0\",\n            params: { mapping: DEPS_DEV_MAPPING, system: \"npm\", package: \"webpack\", version: \"5.90.0\" },\n            endpoint: DEPS_DEV_MAPPING.endpoint,\n            counts: { nodes: 84, edges: 121 },\n        },\n    ],\n});\n\n/**\n * The descriptor of the `openalex` preset. Experimental.\n * @category Network sources\n */\nexport const OPENALEX_DESCRIPTOR: SourceDescriptor = Object.freeze({\n    plainName: \"OpenAlex\",\n    kind: \"rest\",\n    version: 1,\n    defaultEndpoint: \"https://api.openalex.org\",\n    auth: [\"api-key\"],\n    authRequired: \"optional\",\n    rateLimit: { requests: 10, perMs: 1000 },\n    params: [\n        { name: \"work\", plainName: \"Work\", type: \"string\" },\n        { name: \"author\", plainName: \"Author\", type: \"string\" },\n        {\n            name: \"graph\",\n            plainName: \"Graph\",\n            type: \"enum\",\n            default: \"citation\",\n            values: [\n                { value: \"citation\", label: \"Citations\" },\n                { value: \"coauthorship\", label: \"Co-authors\" },\n            ],\n        },\n        { name: \"include\", plainName: \"Include\", type: \"string\", advanced: true },\n    ],\n    samples: [\n        {\n            id: \"openalex-watts-strogatz\",\n            plainName: \"Watts-Strogatz paper's citations\",\n            params: { work: \"W2112090702\" },\n            whole: false,\n        },\n    ],\n});\n"],"names":[],"mappings":"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"}