@nxara/olio-core 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nxara contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,8 @@
-# Temporary Holding Version
+# @nxara/olio-core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The contracts the Nxara packages share, so none of them has to depend on `@nxara/olio`. Apps don't import it: `@nxara/olio` re-exports the types, and `@nxara/olio-tools` the loaders.
+
+- **`Olio`**: the registration interface. Apps still augment it through olio (`declare module "@nxara/olio" { interface Olio { ... } }`), which reaches it here; `@nxara/olio-http` reads the registered `ctx` as `Context`.
+- **Module shapes**: `OlioModule`, `OlioFeature`, `ResolverMap`, `StoredMiddleware` (olio's `MiddlewareMap` is the typed view), and the `LoadedResolvers` / `LoadedEnums` brands that `@nxara/olio-tools` returns.
+- **`TypeSource`, `Pattern`**.
+- **`@nxara/olio-core/files`** (Node only, so `node:fs` stays out of olio's imports): `matchFiles(patterns)` (sorted; a pattern matching nothing throws) and `loadGraphQLFile(file)` (`.graphql` / `.gql`, or a `.ts` / `.js` default export of GraphQL source or a `DocumentNode`; errors carry `file:line:col`). `@nxara/olio-tools` and `@nxara/olio-codegen` load SDL and operations through it, so they read the same files the same way.

package/dist/files.d.ts

@@ -0,0 +1,5 @@
+import { type DocumentNode } from "graphql";
+import type { Pattern } from "./index.js";
+export declare function matchFiles(patterns: readonly Pattern[]): Promise<string[]>;
+export declare function loadGraphQLFile(file: string): Promise<DocumentNode | undefined>;
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,YAAY,CAAC;AAOtD,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CASnB;AAwBD,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkBnC"}

package/dist/files.js

@@ -0,0 +1,43 @@
+import { globSync, readFileSync } from "node:fs";
+import { extname } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { parse, Source } from "graphql";
+const COMMENT = /#[^\n]*/g;
+export async function matchFiles(patterns) {
+    const paths = patterns.map((p) => typeof p === "string" ? p : fileURLToPath(p));
+    const matches = paths.map((path) => globSync(path));
+    for (const [i, found] of matches.entries()) {
+        if (found.length === 0)
+            throw new Error(`No files match "${paths[i]}"`);
+    }
+    return [...new Set(matches.flat())].sort();
+}
+function parseFile(source, file) {
+    try {
+        return parse(new Source(source, file));
+    }
+    catch (error) {
+        const { message, locations } = error;
+        const loc = locations?.[0];
+        throw new Error(`${loc ? `${file}:${loc.line}:${loc.column}` : file}: ${message}`);
+    }
+}
+export async function loadGraphQLFile(file) {
+    const ext = extname(file);
+    if (ext === ".graphql" || ext === ".gql") {
+        const source = readFileSync(file, "utf8");
+        return source.replace(COMMENT, "").trim() === ""
+            ? undefined
+            : parseFile(source, file);
+    }
+    if (ext === ".ts" || ext === ".js") {
+        const mod = (await import(pathToFileURL(file).href));
+        if (!mod.default)
+            return undefined;
+        return typeof mod.default === "string"
+            ? parseFile(mod.default, file)
+            : mod.default;
+    }
+    throw new Error(`Cannot load GraphQL from "${file}" (unknown extension)`);
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAI3D,MAAM,OAAO,GAAG,UAAU,CAAC;AAK3B,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAA4B;IAE5B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAC7C,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,KAAK,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAGD,SAAS,SAAS,CAAC,MAAc,EAAE,IAAY;IAC7C,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAG9B,CAAC;QACF,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAClE,CAAC;IACJ,CAAC;AACH,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY;IAEZ,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;YAC9C,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAElD,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QACnC,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YACpC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC;YAC9B,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,uBAAuB,CAAC,CAAC;AAC5E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+import type { DocumentNode } from "graphql";
+export interface Olio {
+}
+export type Context = Olio extends {
+    ctx: infer C;
+} ? C : unknown;
+export type TypeSource = string | DocumentNode;
+export type Pattern = string | URL;
+export type ResolverMap = Record<string, object>;
+export type StoredMiddleware = Partial<Record<string, Partial<Record<string, readonly unknown[]>>>>;
+declare const loaded: unique symbol;
+export type LoadedResolvers = {
+    readonly [type: string]: never;
+} & {
+    readonly [loaded]: true;
+};
+declare const loadedEnums: unique symbol;
+export type LoadedEnums = {
+    readonly [type: string]: never;
+} & {
+    readonly [loadedEnums]: true;
+};
+export interface OlioModule {
+    readonly id: string;
+    readonly typeDefs: readonly DocumentNode[];
+    readonly resolvers: readonly ResolverMap[];
+    readonly enums: ResolverMap;
+    readonly middleware: StoredMiddleware;
+    readonly features: readonly OlioFeature[];
+}
+export interface OlioFeature {
+    readonly module: string;
+    readonly id: string;
+    readonly typeDefs: readonly DocumentNode[];
+    readonly resolvers: readonly ResolverMap[];
+    readonly enums: ResolverMap;
+    readonly middleware: StoredMiddleware;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAkB5C,MAAM,WAAW,IAAI;CAAG;AAGxB,MAAM,MAAM,OAAO,GAAG,IAAI,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,OAAO,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;AAG/C,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,GAAG,CAAC;AAEnC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAGjD,MAAM,MAAM,gBAAgB,GAAG,OAAO,CACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC,CAAC,CAC5D,CAAC;AAEF,OAAO,CAAC,MAAM,MAAM,EAAE,OAAO,MAAM,CAAC;AASpC,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,GAAG;IACjE,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;CACzB,CAAC;AAEF,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAC;AAMzC,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,GAAG;IAC7D,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;CAC9B,CAAC;AAGF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C;AAGD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;CACvC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@nxara/olio-core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Contracts shared by the Nxara packages. Apps import from @nxara/olio and @nxara/olio-tools instead.",
+  "keywords": [
+    "graphql",
+    "nxara"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nxara-hub/olio.git",
+    "directory": "packages/core"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./files": {
+      "types": "./dist/files.d.ts",
+      "default": "./dist/files.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test",
+    "check-types": "tsc -p tsconfig.test.json"
+  },
+  "devDependencies": {
+    "graphql": "^16.14.2"
+  },
+  "peerDependencies": {
+    "graphql": "^16.13.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}