@intentic/resources 1.18.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artur Kurowski
+
+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

@@ -0,0 +1,25 @@
+# @intentic/resources
+
+The closed **resource vocabulary** shared by the state resolver (which emits these kinds), the engine (which reconciles them), and the providers (which implement them). The graph IR treats a node's `type` as an opaque string; this package is the single authority on which kinds exist and what each produces. Depends only on [`@intentic/graph`](../graph).
+
+## Responsibilities
+
+- Define `ResourceType` — the closed union of every resource kind intentic understands (`host`, `cloudflare`, `forgejo`, `forgejo-runner`, `komodo`, `tunnel`, `cf-route`, `repo`, `ci`, `deployment`, `app`, `backup`, `workspace`, …).
+- Define `ResolvedNode` — a `RawNode` whose `type` is constrained to a `ResourceType`.
+- Catalog `OUTPUTS` — the output fields each kind produces, so downstream nodes can ref them with confidence.
+- It is a vocabulary only: no resolution logic, no reconciliation, no provider code.
+
+## Key files
+
+- [src/resource-types.ts](src/resource-types.ts) — the `ResourceType` union + `ResolvedNode`.
+- [src/outputs.ts](src/outputs.ts) — the `OUTPUTS` map (kind → produced fields).
+- [src/index.ts](src/index.ts) — public surface.
+
+## How it fits
+
+Sits just above `graph`. The `state-resolver` emits `ResolvedNode`s of these types; the `engine` keys its `ResourceType → Provider` map on them; `providers` implements one provider per kind. Adding a new resource kind starts here.
+
+## Conventions & gotchas
+
+- The union is **closed** — adding a kind means updating `ResourceType`, its `OUTPUTS` entry, the emitter in `state-resolver`, and a provider in `providers`, together.
+- Keep `OUTPUTS` accurate: refs are validated against it, so a missing/typo'd output surfaces as a resolve-time error. See [ARCHITECTURE.md](../../ARCHITECTURE.md).

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { OUTPUTS } from "./outputs.js";
+export type { ResolvedNode, ResourceType } from "./resource-types.js";
+//# 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,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

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

package/dist/index.js.map

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

package/dist/outputs.d.ts

@@ -0,0 +1,3 @@
+import type { ResourceType } from "./resource-types.js";
+export declare const OUTPUTS: Readonly<Record<ResourceType, readonly string[]>>;
+//# sourceMappingURL=outputs.d.ts.map

package/dist/outputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.d.ts","sourceRoot":"","sources":["../src/outputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxD,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC,CAuDpE,CAAC"}

package/dist/outputs.js

@@ -0,0 +1,38 @@
+export const OUTPUTS = Object.freeze({
+    host: ["internalIp", "publicIp"],
+    cloudflare: ["zoneId", "accountId"],
+    discord: ["guildId", "reconcileWebhook", "appWebhook:"],
+    "cf-route": ["url"],
+    tunnel: ["tunnelId", "cname"],
+    forgejo: ["url", "internalUrl", "runnerToken", "gitToken", "packagesToken"],
+    "forgejo-user": [],
+    "forgejo-org": [],
+    "forgejo-team": [],
+    repo: ["cloneUrl", "sshUrl"],
+    "control-repo": ["cloneUrl", "sshUrl"],
+    "forgejo-runner": [],
+    komodo: ["url", "internalUrl"],
+    "komodo-periphery": [],
+    "komodo-server": ["serverName"],
+    "komodo-user": [],
+    ci: [],
+    deployment: ["internalUrl", "url"],
+    "forgejo-notify": [],
+    "komodo-notify": [],
+    signoz: ["url", "internalUrl", "otlpEndpoint"],
+    workspace: ["internalUrl", "healthUrl", "previewBase"],
+    backup: [],
+    postgres: ["internalHost", "port"],
+    valkey: ["internalHost", "port"],
+    "postgres-database": ["url"],
+    "valkey-namespace": ["url"],
+    authentik: ["url", "issuerUrl", "internalUrl"],
+    "authentik-client": ["issuer", "clientId", "clientSecret"],
+    garage: ["internalEndpoint", "endpoint"],
+    "garage-bucket": ["endpoint", "accessKey", "secretKey", "bucket"],
+    github: ["owner"],
+    "gh-repo": ["cloneUrl", "sshUrl"],
+    "gh-ci": [],
+    "gh-deployment": ["internalUrl", "url"],
+});
+//# sourceMappingURL=outputs.js.map

package/dist/outputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.js","sourceRoot":"","sources":["../src/outputs.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,OAAO,GAAsD,MAAM,CAAC,MAAM,CAAC;IACpF,IAAI,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC;IAChC,UAAU,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;IAGnC,OAAO,EAAE,CAAC,SAAS,EAAE,kBAAkB,EAAE,aAAa,CAAC;IACvD,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,MAAM,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,CAAC;IAG3E,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,EAAE;IACjB,cAAc,EAAE,EAAE;IAClB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,cAAc,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IACtC,gBAAgB,EAAE,EAAE;IACpB,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B,kBAAkB,EAAE,EAAE;IAEtB,eAAe,EAAE,CAAC,YAAY,CAAC;IAC/B,aAAa,EAAE,EAAE;IACjB,EAAE,EAAE,EAAE;IACN,UAAU,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC;IAClC,gBAAgB,EAAE,EAAE;IACpB,eAAe,EAAE,EAAE;IACnB,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,cAAc,CAAC;IAG9C,SAAS,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,aAAa,CAAC;IAEtD,MAAM,EAAE,EAAE;IAGV,QAAQ,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC;IAGhC,mBAAmB,EAAE,CAAC,KAAK,CAAC;IAC5B,kBAAkB,EAAE,CAAC,KAAK,CAAC;IAG3B,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC;IAC9C,kBAAkB,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,cAAc,CAAC;IAC1D,MAAM,EAAE,CAAC,kBAAkB,EAAE,UAAU,CAAC;IACxC,eAAe,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC;IAEjE,MAAM,EAAE,CAAC,OAAO,CAAC;IAEjB,SAAS,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAEjC,OAAO,EAAE,EAAE;IAEX,eAAe,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC;CAC1C,CAAC,CAAC"}

package/dist/resource-types.d.ts

@@ -0,0 +1,6 @@
+import type { RawNode } from "@intentic/graph";
+export type ResourceType = "host" | "cloudflare" | "github" | "discord" | "cf-route" | "tunnel" | "forgejo" | "forgejo-user" | "forgejo-org" | "forgejo-team" | "repo" | "control-repo" | "forgejo-runner" | "komodo" | "komodo-periphery" | "komodo-server" | "komodo-user" | "ci" | "deployment" | "forgejo-notify" | "komodo-notify" | "signoz" | "workspace" | "backup" | "postgres" | "postgres-database" | "valkey" | "valkey-namespace" | "authentik" | "authentik-client" | "garage" | "garage-bucket" | "gh-repo" | "gh-ci" | "gh-deployment";
+export type ResolvedNode = Omit<RawNode, "type"> & {
+    readonly type: ResourceType;
+};
+//# sourceMappingURL=resource-types.d.ts.map

package/dist/resource-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-types.d.ts","sourceRoot":"","sources":["../src/resource-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAK/C,MAAM,MAAM,YAAY,GAClB,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,UAAU,GACV,QAAQ,GACR,SAAS,GACT,cAAc,GACd,aAAa,GACb,cAAc,GACd,MAAM,GACN,cAAc,GACd,gBAAgB,GAChB,QAAQ,GACR,kBAAkB,GAClB,eAAe,GACf,aAAa,GACb,IAAI,GACJ,YAAY,GACZ,gBAAgB,GAChB,eAAe,GACf,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,UAAU,GACV,mBAAmB,GACnB,QAAQ,GACR,kBAAkB,GAClB,WAAW,GACX,kBAAkB,GAClB,QAAQ,GACR,eAAe,GACf,SAAS,GACT,OAAO,GACP,eAAe,CAAC;AAItB,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC"}

package/dist/resource-types.js

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

package/dist/resource-types.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@intentic/resources",
+  "version": "1.18.0",
+  "description": "",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/radarsu/intentic.git",
+    "directory": "_libs/resources"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": {
+        "@intentic/src": "./src/index.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "@intentic/src": "./src/index.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "dependencies": {
+    "tslib": "2.8.1",
+    "@intentic/graph": "1.18.0"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "@intentic/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --build --watch"
+  }
+}