@k8ts/instruments 0.6.2 → 0.9.0

package/dist/expressions/data-sources/index.js

@@ -1,123 +1,21 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataSource_LocalFile = void 0;
-exports.localFile = localFile;
-exports.isTypedArray = isTypedArray;
-exports.isArrayBuffer = isArrayBuffer;
-exports.resolveText = resolveText;
-exports.resolveBinary = resolveBinary;
-const doddle_1 = require("doddle");
-const promises_1 = require("fs/promises");
-const path_1 = require("path");
-const stacktracey_1 = __importDefault(require("stacktracey"));
-const error_1 = require("../../error");
-class DataSource_LocalFile {
-    _props;
-    constructor(_props) {
-        this._props = _props;
-    }
-    get cwd() {
-        if (this._props.cwd) {
-            return this._props.cwd;
-        }
-        const where = this._props.pointOfCall.at(0);
-        return (0, path_1.dirname)(where.file);
-    }
-    get path() {
-        const where = this._props.pointOfCall.at(0);
-        const joined = (0, path_1.join)((0, path_1.dirname)(where.file), this._props.path);
-        return (0, path_1.resolve)(joined);
-    }
-    contents = (0, doddle_1.doddle)(async () => {
-        const mode = this._props.mode ?? "text";
-        if (mode === "binary") {
-            const data = await (0, promises_1.readFile)(this.path, null);
-            return data;
-        }
-        return (0, promises_1.readFile)(this.path, "utf-8");
-    });
-}
-exports.DataSource_LocalFile = DataSource_LocalFile;
-function localFile(args, ...params) {
-    if (typeof args === "string") {
-        const options = params[0] ?? {};
-        return new DataSource_LocalFile({
-            pointOfCall: new stacktracey_1.default().slice(1),
-            path: args,
-            ...(options ?? {})
-        });
-    }
-    const path = String.raw(args, ...params);
-    return new DataSource_LocalFile({
-        pointOfCall: new stacktracey_1.default().slice(1),
-        path
-    });
-}
-function isTypedArray(data) {
-    return (typeof data === "object" &&
-        "buffer" in data &&
-        "byteSize" in data &&
-        typeof data.byteSize === "number");
-}
-function isArrayBuffer(data) {
-    return data instanceof ArrayBuffer;
-}
-async function promiseAllMap(m) {
-    const promises = (0, doddle_1.seq)(m)
-        .map(async (x) => [x[0], await x[1].pull()])
-        .toArray()
-        .pull();
-    const res = await Promise.all(promises);
-    return new Map(res);
-}
-async function resolveText(record) {
-    const mp = (0, doddle_1.seq)(Object.entries(record))
-        .map(([k, v]) => {
-        return [
-            k,
-            (0, doddle_1.doddle)(async () => {
-                let resolved = v;
-                if (v instanceof DataSource_LocalFile) {
-                    resolved = await v.contents.pull();
-                }
-                if (typeof resolved !== "string") {
-                    throw new error_1.InstrumentsError(`Got an invalid data value ${v} for key ${k}. Must be a string.`);
-                }
-                return resolved;
-            })
-        ];
-    })
-        .toMap(x => x)
-        .pull();
-    return promiseAllMap(mp);
-}
-async function resolveBinary(record) {
-    const mp = (0, doddle_1.seq)(Object.entries(record))
-        .map(([k, v]) => {
-        return [
-            k,
-            (0, doddle_1.doddle)(async () => {
-                let resolved = v;
-                if (v instanceof DataSource_LocalFile) {
-                    resolved = await v.contents.pull();
-                }
-                if (isTypedArray(resolved)) {
-                    return new Uint8Array(resolved.buffer);
-                }
-                else if (isArrayBuffer(resolved)) {
-                    return new Uint8Array(resolved);
-                }
-                else {
-                    throw new error_1.InstrumentsError(`Got an invalid data value ${v} for key ${k}. Must be binary data.`);
-                }
-            })
-        ];
-    })
-        .toMap(x => x)
-        .pull();
-    return promiseAllMap(mp);
-}
+__exportStar(require("./base"), exports);
+__exportStar(require("./env-var"), exports);
+__exportStar(require("./interface"), exports);
+__exportStar(require("./local-file"), exports);
 //# sourceMappingURL=index.js.map

package/dist/expressions/data-sources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/expressions/data-sources/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/expressions/data-sources/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB;AACtB,4CAAyB;AACzB,8CAA2B;AAC3B,+CAA4B"}

package/dist/expressions/data-sources/interface.d.ts

@@ -0,0 +1,7 @@
+export type DataSource_Type_Name = "string" | "binary";
+export type DataSource_Value<Name extends DataSource_Type_Name> = Name extends "string" ? string : Name extends "binary" ? Uint8Array : DataSource_Type_Name;
+export interface DataSource_Object<TypeName extends DataSource_Type_Name = DataSource_Type_Name> {
+    get(): DataSource_Value<TypeName> | Promise<DataSource_Value<TypeName>>;
+}
+export type DataSource<Only extends DataSource_Type_Name = DataSource_Type_Name> = DataSource_Object<Only> | DataSource_Value<Only>;
+//# sourceMappingURL=interface.d.ts.map

package/dist/expressions/data-sources/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/expressions/data-sources/interface.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,CAAA;AACtD,MAAM,MAAM,gBAAgB,CAAC,IAAI,SAAS,oBAAoB,IAAI,IAAI,SAAS,QAAQ,GACjF,MAAM,GACN,IAAI,SAAS,QAAQ,GACnB,UAAU,GACV,oBAAoB,CAAA;AAC5B,MAAM,WAAW,iBAAiB,CAAC,QAAQ,SAAS,oBAAoB,GAAG,oBAAoB;IAC3F,GAAG,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAA;CAC1E;AAED,MAAM,MAAM,UAAU,CAAC,IAAI,SAAS,oBAAoB,GAAG,oBAAoB,IACzE,iBAAiB,CAAC,IAAI,CAAC,GACvB,gBAAgB,CAAC,IAAI,CAAC,CAAA"}

package/dist/expressions/data-sources/interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interface.js.map

package/dist/expressions/data-sources/interface.js.map

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

package/dist/expressions/data-sources/local-file.d.ts

@@ -0,0 +1,13 @@
+import Path from "pathlib-js";
+import type { TypedArray } from "what-are-you";
+import { DataSource_Lazy } from "./base";
+export type DataSource_Allowed = string | Uint8Array | TypedArray;
+export declare class DataSource_LocalFile_Path {
+    private readonly _cwd;
+    readonly path: Path;
+    constructor(_cwd: Path, relPath: string);
+    as(mode: "text", encoding?: BufferEncoding): DataSource_Lazy<string>;
+    as(mode: "binary"): DataSource_Lazy<Uint8Array>;
+}
+export declare function localRefFile(path: string): DataSource_LocalFile_Path;
+//# sourceMappingURL=local-file.d.ts.map

package/dist/expressions/data-sources/local-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file.d.ts","sourceRoot":"","sources":["../../../src/expressions/data-sources/local-file.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,YAAY,CAAA;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AACxC,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAA;AACjE,qBAAa,yBAAyB;IAG9B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFzB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;gBAEE,IAAI,EAAE,IAAI,EAC3B,OAAO,EAAE,MAAM;IAKnB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC;IACpE,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC;CAQlD;AAqBD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,6BAIxC"}

package/dist/expressions/data-sources/local-file.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataSource_LocalFile_Path = void 0;
+exports.localRefFile = localRefFile;
+const pathlib_js_1 = __importDefault(require("pathlib-js"));
+const stacktracey_1 = __importDefault(require("stacktracey"));
+const base_1 = require("./base");
+class DataSource_LocalFile_Path {
+    _cwd;
+    path;
+    constructor(_cwd, relPath) {
+        this._cwd = _cwd;
+        this.path = this._cwd.join(relPath);
+    }
+    as(mode, encoding) {
+        if (mode === "text") {
+            return new DataSource_LocalFile_Text(this, encoding);
+        }
+        else {
+            return new DataSource_LocalFile_Binary(this);
+        }
+    }
+}
+exports.DataSource_LocalFile_Path = DataSource_LocalFile_Path;
+class DataSource_LocalFile_Text extends base_1.DataSource_Lazy {
+    _parent;
+    encoding;
+    constructor(_parent, encoding = "utf-8") {
+        super(async () => {
+            return this._parent.path.readFile(this.encoding);
+        });
+        this._parent = _parent;
+        this.encoding = encoding;
+    }
+}
+class DataSource_LocalFile_Binary extends base_1.DataSource_Lazy {
+    _parent;
+    constructor(_parent) {
+        super(async () => {
+            const x = await this._parent.path.readFile();
+            return new Uint8Array(x);
+        });
+        this._parent = _parent;
+    }
+}
+function localRefFile(path) {
+    const trace = new stacktracey_1.default().slice(1);
+    const callerFile = trace.at(0).file;
+    return new DataSource_LocalFile_Path(new pathlib_js_1.default(callerFile).parent(), path);
+}
+//# sourceMappingURL=local-file.js.map

package/dist/expressions/data-sources/local-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file.js","sourceRoot":"","sources":["../../../src/expressions/data-sources/local-file.ts"],"names":[],"mappings":";;;;;;AA4CA,oCAIC;AAhDD,4DAA6B;AAC7B,8DAAqC;AAErC,iCAAwC;AAExC,MAAa,yBAAyB;IAGb;IAFZ,IAAI,CAAM;IACnB,YACqB,IAAU,EAC3B,OAAe;QADE,SAAI,GAAJ,IAAI,CAAM;QAG3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IAID,EAAE,CAAC,IAAuB,EAAE,QAAyB;QACjD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAClB,OAAO,IAAI,yBAAyB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACxD,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAA;QAChD,CAAC;IACL,CAAC;CACJ;AAlBD,8DAkBC;AACD,MAAM,yBAA0B,SAAQ,sBAAuB;IAEtC;IACR;IAFb,YACqB,OAAkC,EAC1C,WAA2B,OAAO;QAE3C,KAAK,CAAC,KAAK,IAAI,EAAE;YACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACpD,CAAC,CAAC,CAAA;QALe,YAAO,GAAP,OAAO,CAA2B;QAC1C,aAAQ,GAAR,QAAQ,CAA0B;IAK/C,CAAC;CACJ;AAED,MAAM,2BAA4B,SAAQ,sBAA2B;IACpC;IAA7B,YAA6B,OAAkC;QAC3D,KAAK,CAAC,KAAK,IAAI,EAAE;YACb,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC5C,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QAJuB,YAAO,GAAP,OAAO,CAA2B;IAK/D,CAAC;CACJ;AAED,SAAgB,YAAY,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,qBAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACnC,OAAO,IAAI,yBAAyB,CAAC,IAAI,oBAAI,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAA;AAC7E,CAAC"}

package/dist/utils/tagged-template.d.ts

@@ -0,0 +1,2 @@
+export declare function createTaggedTemplate<DataSource_T>(f: (joined: string) => DataSource_T): (tArgs: TemplateStringsArray, ...params: any[]) => DataSource_T;
+//# sourceMappingURL=tagged-template.d.ts.map

package/dist/utils/tagged-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tagged-template.d.ts","sourceRoot":"","sources":["../../src/utils/tagged-template.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,IAC1E,OAAO,oBAAoB,EAAE,GAAG,QAAQ,GAAG,EAAE,kBAIxD"}

package/dist/utils/tagged-template.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTaggedTemplate = createTaggedTemplate;
+function createTaggedTemplate(f) {
+    return (tArgs, ...params) => {
+        const joined = String.raw(tArgs, ...params);
+        return f(joined);
+    };
+}
+//# sourceMappingURL=tagged-template.js.map

package/dist/utils/tagged-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tagged-template.js","sourceRoot":"","sources":["../../src/utils/tagged-template.ts"],"names":[],"mappings":";;AAAA,oDAKC;AALD,SAAgB,oBAAoB,CAAe,CAAmC;IAClF,OAAO,CAAC,KAA2B,EAAE,GAAG,MAAa,EAAE,EAAE;QACrD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,CAAA;QAC3C,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;IACpB,CAAC,CAAA;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k8ts/instruments",
-  "version": "0.6.2",
+  "version": "0.9.0",
   "description": "A collection of utilities and core components for k8ts.",
   "keywords": [
     "k8ts",
@@ -66,13 +66,15 @@
     "ip-address": "^10.0.1",
     "lodash": "^4.17.21",
     "parjs": "^1.3.9",
+    "pathlib-js": "^1.5.0",
+    "pathlib-ts": "^0.1.2",
     "simple-git": "^3.27.0",
     "stacktracey": "^2.1.8",
     "timezone-enum": "^1.0.4",
-    "what-are-you": "^0.1.12"
+    "what-are-you": "^0.2.0"
   },
   "devDependencies": {
-    "@k8ts/metadata": "0.5.2",
+    "@k8ts/metadata": "^0.7.0",
     "@types/jest": "^30.0.0",
     "@types/lodash": "^4.17.16",
     "@types/node": "20.9.1",
@@ -86,7 +88,7 @@
     "yamprint": "^0.8.4"
   },
   "peerDependencies": {
-    "@k8ts/metadata": "^0.5.2"
+    "@k8ts/metadata": "^0.7.0"
   },
   "engines": {
     "node": ">=16.0.0"

package/src/core/graph/origin/entity.ts

@@ -5,7 +5,7 @@ import { mapValues } from "lodash"
 import { displayers } from "../../../utils/displayers"
 import { Entity } from "../entity"
 import type { Resource_Entity } from "../resource/entity"
-import type { Resource_Core_Ref } from "../resource/reference/refable"
+import type { Ref2_Of } from "../resource/reference/refable"
 import { OriginEventsEmitter, type Origin_EventMap } from "./events"
 import { KindMap } from "./kind-map"
 import { OriginNode, type Origin_Props } from "./node"
@@ -104,7 +104,7 @@ export abstract class Origin_Entity<Props extends Origin_Props = Origin_Props> e
     }
 
     // We don't cache this because resources can be added dynamically
-    get resources(): Iterable<Resource_Core_Ref> {
+    get resources(): Iterable<Ref2_Of> {
         const self = this
         return seq(function* () {
             for (const resource of self._ownResources) {

package/src/core/graph/origin/exporter.ts

@@ -1,6 +1,6 @@
 import { doddlify, seq } from "doddle"
 import type { Resource_Top } from "../resource"
-import { FwReference, type Resource_Core_Ref } from "../resource"
+import { FwReference, type Ref2_Of } from "../resource"
 import { Origin_Entity } from "./entity"
 import type { Origin_Props } from "./node"
 
@@ -19,17 +19,17 @@ export abstract class Origin_Exporter<
         this._parent["__attach_kid__"](this)
     }
 
-    protected abstract __exports__(): Iterable<Resource_Core_Ref>
+    protected abstract __exports__(): Iterable<Ref2_Of>
 
     protected __parent__() {
         return this._parent
     }
 
     @doddlify
-    get resources(): Iterable<Resource_Core_Ref> {
+    get resources(): Iterable<Ref2_Of> {
         const self = this
         const boundExports = self.__binder__().bind(self.__exports__.bind(self))
-        const allEmitted = new Set<Resource_Core_Ref>()
+        const allEmitted = new Set<Ref2_Of>()
         const normalResources = seq(() => super.resources).cache()
         return seq(function* () {
             for (const em of boundExports() as Resource_Top[]) {
@@ -43,7 +43,7 @@ export abstract class Origin_Exporter<
                 }
 
                 allEmitted.add(em)
-                if (em._origin.equals(self)) {
+                if (em["__origin__"]().equals(self)) {
                     // Means it's being exported for the first time
                     self.__emit__("resource/exported", {
                         origin: self,

package/src/core/graph/origin/external.ts

@@ -0,0 +1,18 @@
+import type { Resource_Ctor_Of } from "../resource"
+import { Origin_Entity } from "./entity"
+import type { Origin_Props } from "./node"
+
+export class Origin_External extends Origin_Entity {
+    get kind() {
+        return "[k8ts] External"
+    }
+    private constructor() {
+        super("External", {})
+    }
+
+    protected __parent__(): Origin_Entity<Origin_Props<Resource_Ctor_Of>> | undefined {
+        return undefined
+    }
+
+    static instance = new Origin_External()
+}

package/src/core/graph/origin/index.ts

@@ -1,6 +1,7 @@
 export * from "./entity"
 export * from "./events"
 export * from "./exporter"
+export * from "./external"
 export * from "./kind-map"
 export * from "./node"
 export * from "./tracker"

package/src/core/graph/origin/kind-map/index.ts

@@ -53,14 +53,6 @@ export class KindMap<Kinds extends Resource_Ctor_Of = Resource_Ctor_Of> {
             .pull()
     }
 
-    refKey<Kind extends Kind.IdentParent, Name extends string>(
-        kind: Kind,
-        name: Name
-    ): RefKey<Kind, Name> {
-        const trueKind = this.getKind(kind)
-        return new RefKey(trueKind, name) as any
-    }
-
     parse(ref: string | RefKey<this["__KINDS__"]>): RefKey<this["__KINDS__"]> {
         const result = this.tryParse(ref)
         if (!result) {
@@ -90,7 +82,10 @@ export class KindMap<Kinds extends Resource_Ctor_Of = Resource_Ctor_Of> {
         if (!ident) {
             return undefined
         }
-        return this.refKey(ident, name)
+
+        return (ident as Kind.Kind).refKey({
+            name
+        })
     }
 
     get kinds(): Set<string> {
@@ -142,8 +137,8 @@ export class KindMap<Kinds extends Resource_Ctor_Of = Resource_Ctor_Of> {
         return this._entriesMap.get(converted)
     }
 
-    tryGetKind(kindOrIdent: LookupKey): any {
-        return this._tryGetEntry(kindOrIdent)?.ident as Kinds | undefined
+    tryGetKind(kindOrIdent: LookupKey): this["__KINDS__"] | undefined {
+        return this._tryGetEntry(kindOrIdent)?.ident as this["__KINDS__"] | undefined
     }
 
     getKind(kindOrClass: LookupKey): this["__KINDS__"] {

package/src/core/graph/origin/node.ts

@@ -3,7 +3,7 @@ import chalk from "chalk"
 import { seq, Seq } from "doddle"
 import { displayers } from "../../../utils/displayers"
 import { Node } from "../node"
-import type { Resource_Core_Ref, Resource_Ctor_Of } from "../resource"
+import type { Ref2_Of, Resource_Ctor_Of } from "../resource"
 import type { Origin_Entity } from "./entity"
 import { type KindMapInput } from "./kind-map"
 
@@ -54,7 +54,7 @@ export class OriginNode extends Node<OriginNode, Origin_Entity> {
     get resources() {
         return this.entity.resources
     }
-    readonly attachedTree: Seq<Resource_Core_Ref> = seq(() => {
+    readonly attachedTree: Seq<Ref2_Of> = seq(() => {
         const self = this
         const desc = self.descendants
             .concatTo([this])

package/src/core/graph/origin/tracker.ts

@@ -1,6 +1,6 @@
 import { AsyncLocalStorage } from "async_hooks"
 import { doddle, pull, type Doddle, type MaybeDoddle } from "doddle"
-import { isIterable } from "what-are-you"
+import { isIterable, type AnyCtor } from "what-are-you"
 import type { Origin_Entity } from "./entity"
 
 export interface OriginStackBinder {
@@ -18,6 +18,17 @@ export class _OriginContextTracker {
         return this._store.getStore()
     }
 
+    firstOfType<X extends Origin_Entity>(t: AnyCtor<X>): X {
+        let current = this._store.getStore()
+        while (current) {
+            if (current instanceof t) {
+                return current
+            }
+            current = current["__parent__"]()
+        }
+        throw new Error(`No origin of type ${t.name} found in the current origin stack`)
+    }
+
     disposableOriginModifier(origin: Origin_Entity): Disposable {
         const curOrigin = this._store.getStore()
         this._store.enterWith(origin)

package/src/core/graph/resource/api-kind/index.ts

@@ -1,7 +1,8 @@
 import { InstrumentsError } from "../../../../error"
 import { bind_own_methods } from "../../../../utils"
 import { displayers } from "../../../../utils/displayers"
-import { RefKey } from "../ref-key"
+import { External_Base, type External_Props, type External_WithFeatures } from "../external"
+import { RefKey, type RefKey_Options } from "../ref-key"
 import { pluralize } from "./pluralize"
 
 export type Kind<
@@ -119,10 +120,21 @@ export namespace Kind {
             super(name, parent)
         }
 
-        refKey<Name extends string>(name: Name) {
-            return new RefKey<this, Name>(this as any, name)
+        refKey<Name extends string>(options: RefKey_Options<Name>) {
+            return new RefKey<this, Name>(this as any, options)
+        }
+        External<
+            N extends string = string,
+            const P extends External_Props<this> = External_Props<this>
+        >(options: P & RefKey_Options<N>): External_WithFeatures<this, P> {
+            return new External_Base(
+                this.refKey({
+                    name: options.name,
+                    namespace: options.namespace
+                }),
+                options ?? {}
+            ) as any
         }
-
         get plural() {
             return pluralize(this.name.toLowerCase())
         }

package/src/core/graph/resource/entity.ts

@@ -20,7 +20,9 @@ export abstract class Resource_Entity<
         callback(this)
         return this
     }
-
+    is<K extends Kind.IdentParent>(kind: K): this is { kind: K } {
+        return this.kind.equals(kind)
+    }
     abstract readonly namespace: string | undefined
 
     ref() {

package/src/core/graph/resource/external/base.ts

@@ -0,0 +1,47 @@
+import { Meta } from "@k8ts/metadata"
+import { Origin_External } from "../../origin"
+import type { Kind } from "../api-kind"
+import { Resource_Entity } from "../entity"
+import type { RefKey } from "../ref-key"
+export class External_Base<K extends Kind.IdentParent> extends Resource_Entity<string, any> {
+    readonly meta = Meta.make()
+    constructor(
+        readonly key: RefKey<K>,
+        props: any
+    ) {
+        super(key.name, props)
+
+        this.meta.add({
+            name: key.name,
+            namespace: key.namespace,
+            "#k8ts.org/is-external": "true"
+        })
+
+        if (props.keys) {
+            Object.defineProperties(this, {
+                keys: {
+                    get: () => props.keys
+                }
+            })
+        }
+    }
+
+    protected __origin__() {
+        return Origin_External.instance
+    }
+    get namespace() {
+        return this.meta.tryGet("namespace")
+    }
+
+    get kind() {
+        return this.key.kind
+    }
+
+    ref() {
+        return {
+            kind: this.kind.name,
+            name: this.name,
+            namespace: this.namespace
+        }
+    }
+}

package/src/core/graph/resource/external/features.ts

@@ -0,0 +1,16 @@
+import type { Kind } from "../api-kind"
+import type { External_Base } from "./base"
+import type { External_Props } from "./props"
+
+export type External_WithFeatures<
+    Kind extends Kind.IdentParent,
+    F extends External_Props<Kind>
+> = External_Base<Kind> & {
+    kind: Kind
+} & (F extends {
+        readonly keys: infer Ks extends string[]
+    }
+        ? {
+              readonly keys: Ks
+          }
+        : {})

package/src/core/graph/resource/external/index.ts

@@ -0,0 +1,3 @@
+export * from "./base"
+export * from "./features"
+export * from "./props"

package/src/core/graph/resource/external/props.ts

@@ -0,0 +1,16 @@
+import type { Kind } from "../api-kind"
+
+export interface External_Features {
+    keys?: string[]
+}
+export interface External_KindToFeatures {
+    ConfigMap: {
+        keys?: string[]
+    }
+    Secret: {
+        keys?: string[]
+    }
+    [s: string]: {}
+}
+
+export type External_Props<K extends Kind.IdentParent> = External_KindToFeatures[K["name"]]

package/src/core/graph/resource/index.ts

@@ -1,6 +1,8 @@
 export * from "./api-kind"
 export * from "./child"
 export * from "./entity"
+export * from "./external"
+export * from "./field"
 export * from "./node"
 export * from "./ref-key"
 export * from "./reference"