@voxgig/sdkgen-infrapack 0.0.1

package/.sdk/tm/seneca-provider/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][mozilla coc].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][faq]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[mozilla coc]: https://github.com/mozilla/diversity
+[faq]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

package/.sdk/tm/seneca-provider/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Seneca Microservices Framework
+
+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/.sdk/tm/seneca-provider/Makefile

@@ -0,0 +1,15 @@
+.PHONY: all build test clean reset
+
+all: build test
+
+build:
+	npm run build
+
+test:
+	npm test
+
+clean:
+	rm -rf dist dist-test .tsbuildinfo
+
+reset:
+	npm run reset

package/.sdk/tm/seneca-provider/src/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "module": "nodenext",
+    "noEmitOnError": true,
+    "outDir": "../dist",
+    "rootDir": ".",
+    "tsBuildInfoFile": "../.tsbuildinfo/src.json",
+    "resolveJsonModule": true,
+    "sourceMap": true,
+    "strict": true,
+    "target": "es2022",
+    "useDefineForClassFields": false,
+    "declaration": true,
+    "declarationDir": "../dist",
+    "types": ["node"]
+  }
+}

package/.sdk/tm/seneca-provider/test/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "module": "nodenext",
+    "noEmitOnError": true,
+    "outDir": "../dist-test",
+    "rootDir": ".",
+    "tsBuildInfoFile": "../.tsbuildinfo/test.json",
+    "resolveJsonModule": true,
+    "sourceMap": true,
+    "strict": true,
+    "target": "es2022",
+    "types": ["node"]
+  },
+  "include": ["**/*.ts"]
+}

package/.sdk/tm/seneca-provider/tsfmt.json

@@ -0,0 +1,3 @@
+{
+  "indentSize": 2
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 voxgig
+
+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,123 @@
+# @voxgig/sdkgen-infrapack
+
+**Infrastructure-provider targets** for the
+[Voxgig SDK Generator](https://github.com/voxgig/sdkgen).
+
+An infrastructure provider is not an SDK. It is a plugin for someone else's
+system — Seneca, Terraform — that exposes your API's entities in that system's
+own vocabulary, layered on the SDK generated from the same model. Every target
+here wraps a language target rather than being one.
+
+```bash
+npm install --save-dev @voxgig/sdkgen-infrapack
+voxgig-sdkgen package add @voxgig/sdkgen-infrapack
+npm run generate
+```
+
+## Targets
+
+| target | wraps | produces |
+|---|---|---|
+| `seneca-provider` | `ts` | a [Seneca](https://senecajs.org) plugin exposing entities as `provider/<name>/<entity>` |
+
+`terraform-provider` is designed and not yet built; see the design notes in the
+sdkgen repository.
+
+## Every target here needs the target it wraps
+
+These are consumer targets: they switch every standard generation phase off and
+emit their whole package from `Main`, and each one fails without the target it
+wraps, deliberately. Add `ts` to your project before `seneca-provider`.
+
+There is no manifest field for that requirement. Nothing in
+`sdkgen-package.json` says "this target needs that one", so this paragraph and
+the error at generation are where the requirement lives.
+
+## Custom actions reach Seneca as `action$`
+
+An API definition folds a non-CRUD verb into an ordinary operation as an
+alternative route — GitHub's `PUT /repos/{owner}/{repo}/pulls/{n}/merge` is a
+second point of the pull request's `update`. The SDK selects one with
+`$action` in the call's argument. Seneca has no operation to add it to, so the
+provider takes it as a directive, spelled the Seneca way:
+
+```js
+const pull = seneca.entity('provider/github/pull')
+
+await pull
+  .make$({ id: 42, owner: 'voxgig', repo: 'sdkgen',
+           commit_title: 'Merge pull request #42' })
+  .directive$({ action$: 'merge' })
+  .save$()
+```
+
+`save$` routes by the operation the action belongs to, not by the command, so
+an action folded into `create` is called as a create even on an entity that
+carries an id. A name the entity does not have throws, naming the valid ones —
+it never falls back to the plain command. Each generated provider lists its own
+actions in its README and its reference.
+
+`make$({ action$ })` does not work and cannot: `seneca-entity`'s `make$` copies
+only keys without a `$`, plus the four directives it knows by name, so any
+other trailing-`$` key is dropped before a store sees it. Use `directive$`, or
+assign the property to an entity you have already made.
+
+Providers generated before this gain their actions on the next regeneration.
+
+
+## `seneca-provider` generates into its own repository
+
+Unlike a language target, a Seneca provider is not a folder in the SDK
+repository. It is an independently released npm package under the `@seneca`
+scope, with its own license, workflow and release cadence, and it depends on
+the SDK as an ordinary published dependency. Point it at that repository from
+your project model:
+
+```
+main: kit: target: 'seneca-provider': output: path: '../../seneca/seneca-acme-provider'
+```
+
+The path resolves against the SDK repository root. Left unset, the provider
+generates in-tree under `seneca-provider/`, which is a usable default for a
+first look at the output.
+
+Set that in `model/project.aon`, not in the target's own file — `target add`
+overwrites the latter.
+
+## Parity
+
+Every target here declares `CONSUMER`. That is not a coverage tier alongside
+`FULL`, `MIRRORED` and `UNCOVERED`, which grade a language target against the
+shared corpus. A consumer target has no utility layer to measure, so it is
+outside that system — and says so, rather than omitting the field, which cannot
+be told apart from an author who did not know it existed.
+
+## Developing
+
+```bash
+npm install
+npm test          # type-checks the components, then runs the suite
+```
+
+The suite runs on `@voxgig/sdkgen/testkit`: it installs this package into a
+staged consumer through the real `package add`, compiles the components the way
+a consumer's build does, and generates.
+
+Two tests **skip** against a published sdkgen whose test kit predates the
+`outside` option, which is what lets a suite express out-of-tree generation at
+all. They report the skip rather than passing quietly, and start running as
+soon as that release lands.
+
+Validate the package itself with:
+
+```bash
+npx voxgig-sdkgen package check .
+```
+
+## Provenance
+
+`seneca-provider` was generated from the same trees that shipped inside
+`@voxgig/sdkgen`. Before it moved, its output was compared file by file against
+the bundled version from the same model: **21 files, 0 differences**, identical
+warnings and an identical placeholder scan. Nothing about a generated provider
+changed in the move.

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@voxgig/sdkgen-infrapack",
+  "version": "0.0.1",
+  "description": "Infrastructure-provider targets for the Voxgig SDK Generator: Seneca provider.",
+  "type": "commonjs",
+  "license": "MIT",
+  "keywords": [
+    "voxgig",
+    "sdkgen",
+    "sdkgen-package",
+    "seneca",
+    "seneca-provider",
+    "provider"
+  ],
+  "author": "Richard Rodger (http://richardrodger.com)",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/voxgig/sdkgen-infrapack.git"
+  },
+  "files": [
+    ".sdk",
+    "sdkgen-package.json"
+  ],
+  "scripts": {
+    "test": "node --enable-source-maps --test test/*.test.js",
+    "test-some": "node --enable-source-maps --test-name-pattern=\"$npm_config_pattern\" --test test/*.test.js",
+    "watch": "tsc -w",
+    "build": "tsc",
+    "clean": "rm -rf node_modules yarn.lock package-lock.json .build",
+    "reset": "npm run clean && npm i && npm run build && npm test",
+    "repo-tag": "REPO_VERSION=`node -e \"console.log(require('./package').version)\"` && echo TAG: v$REPO_VERSION && git commit -a -m v$REPO_VERSION && git push && git tag v$REPO_VERSION && git push --tags;",
+    "repo-publish": "npm run clean && npm i && npm run repo-publish-quick",
+    "repo-publish-quick": "npm run build && npm run test && npm run repo-tag && npm publish --registry https://registry.npmjs.org --access=public",
+    "resset": "npm run reset",
+    "check-cmp": "tsc -p tsconfig.json --noEmit",
+    "check-package": "voxgig-sdkgen package check .",
+    "build:provider-test": "tsc --ignoreConfig --noCheck --noResolve --target ES2021 --module node16"
+  },
+  "_peer_comment": [
+    "A MIGRATED TARGET INHERITS SDKGEN'S PEERS AS ITS OWN. These components",
+    "import @voxgig/sdkgen and @voxgig/apidef BY NAME, which resolved silently",
+    "while the target lived in the bundled scaffold beside sdkgen's own",
+    "node_modules. Out here they have to be declared, or the components fail",
+    "to type-check for the author and fail to resolve for anyone who installs",
+    "this package without sdkgen's peers present.",
+    "",
+    "Peers rather than dependencies: a consumer necessarily has these already,",
+    "via sdkgen, and a second copy at a different version is the one outcome",
+    "worth preventing.",
+    "",
+    "NOT @seneca/maintain, AND NOT ANY OTHER SENECA PACKAGE. The migration",
+    "guide's candidate-check grep prints @seneca/maintain for this target, and",
+    "declaring it here would be wrong: the hit is inside the template literal",
+    "in Extras that WRITES the generated provider's test file. The Seneca",
+    "packages are dependencies of the generated provider, declared in",
+    ".sdk/model/target/seneca-provider.aon's `deps` block, and a consumer of",
+    "THIS package has no reason to supply any of them. The grep cannot tell an",
+    "import from an emitted string; expect that from any target generating a",
+    "Node package.",
+    "",
+    "No @voxgig/struct either \u2014 haskell needs it, this target does not.",
+    "",
+    "The apidef floor MATCHES SDKGEN'S OWN peer range rather than being",
+    "chosen here. A consumer satisfies this package through sdkgen, so a",
+    "looser range would only let npm resolve an apidef that sdkgen itself",
+    "rejects \u2014 a package that installs and then fails to generate.",
+    "",
+    "THE SDKGEN FLOOR IS THE OLDEST PUBLISHED VERSION THIS SUITE IS RUN",
+    "AGAINST, which is 4.9.0. Not the oldest that might work: a floor nobody",
+    "tests is the shape of the old >=3.5.0, which accepted versions where a",
+    "target's components install and then die at generation on a missing",
+    "export \u2014 this target calls `pointSegments`, which sdkgen first exported",
+    "in 4.8.0. 4.9.0 is also the first release carrying the test kit this",
+    "suite runs on.",
+    "",
+    "This is a SEPARATE REPOSITORY, so there is no `file:` path back to the",
+    "generator: the dependency is the published package, and that is the",
+    "point. It makes this package's CI the thing that catches an sdkgen",
+    "release breaking a packaged target.",
+    "",
+    "@types/node IS REQUIRED, not incidental: these components import",
+    "`node:path` and read `__dirname`. Inside the sdkgen checkout they",
+    "hoisted from the generator's own devDependencies; standing alone that",
+    "hoist is gone and the type-check lane fails."
+  ],
+  "peerDependencies": {
+    "@voxgig/apidef": ">=8.2.2",
+    "@voxgig/sdkgen": ">=4.9.0"
+  },
+  "devDependencies": {
+    "@voxgig/apidef": ">=8.2.2",
+    "@voxgig/sdkgen": ">=4.9.0",
+    "aontu": ">=0.52",
+    "memfs": "4.68.1",
+    "typescript": "7.0.2",
+    "@types/node": ">=24"
+  }
+}

package/sdkgen-package.json

@@ -0,0 +1,18 @@
+{
+  "sdkgen": {
+    "package": 1
+  },
+  "name": "@voxgig/sdkgen-infrapack",
+  "version": "1.1.0",
+  "engines": {
+    "sdkgen": ">=4.9.0"
+  },
+  "provides": {
+    "target": [
+      "seneca-provider"
+    ]
+  },
+  "parity": {
+    "seneca-provider": "CONSUMER"
+  }
+}