@voxgig/station 0.0.1

package/dist/src/shape.js

@@ -0,0 +1,444 @@
+"use strict";
+/* The config grammar, as data (design §4).
+ *
+ * TWO STEPS, AND THE FIRST IS WHAT MAKES THE SECOND HONEST.
+ *
+ * struct drops the unexpected-key check for a map whose spec node ends
+ * up empty - "an empty spec object means the object can be open". An
+ * optional key is `['$ONE','$NIL', spec]`, and when the data does not
+ * carry that key the validator REMOVES it from the spec node. So a
+ * block whose keys are all optional degenerates into an open map
+ * exactly when the data has none of them, and `{"solar": {"bass": 1}}`
+ * validates clean - the one property the whole exercise is for,
+ * silently absent in the one case that matters.
+ *
+ * So: normalizeConfig materializes every documented default, and
+ * validateConfig then runs a shape WITH NO OPTIONAL CONTAINERS AT ALL.
+ * After normalization every container is present, so the shape can
+ * require them, so unexpected-key detection is live at every level and
+ * every error names its path. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MERGE_SENSITIVE = exports.BLOCK_DEFAULTS = exports.PROFILE_DEFAULTS = void 0;
+exports.normalizeConfig = normalizeConfig;
+exports.configShape = configShape;
+exports.validateConfig = validateConfig;
+const struct_1 = require("@voxgig/struct");
+const sekreto_1 = require("@voxgig/sekreto");
+const config_shape_1 = require("./config-shape");
+const error_1 = require("./error");
+const descriptor_1 = require("./descriptor");
+// ---------------------------------------------------------------------
+// The defaults table - ONE table, two callers
+// ---------------------------------------------------------------------
+/** Profile-level containers. Safe to materialize early either way:
+ * they are containers, and a missing one merges as empty regardless. */
+exports.PROFILE_DEFAULTS = {
+    secrets: () => ({ providers: [{ kind: 'env' }] }),
+    api: () => ({}),
+    sdk: () => ({}),
+    feature: () => ({}),
+};
+/** Block-level. `feature` is a container and safe early.
+ *
+ * `active` IS NOT, and that is the whole timing rule: a default
+ * synthesized into an OVERLAY block overwrites the base's real value
+ * and silently reactivates an integration the base deliberately barred
+ * (§3.3). So the two consumers read this same table at different
+ * moments - validateConfig before, to every block, because a block with
+ * no present keys is an open map; the resolver AFTER, to the merged
+ * instance, because an absent key must stay absent through the merge. */
+exports.BLOCK_DEFAULTS = {
+    active: () => true,
+    feature: () => ({}),
+};
+/** The one block key carrying the timing rule. Named rather than
+ * inferred, so a reader does not have to work out which of the two it
+ * is, and so a port can assert it. */
+exports.MERGE_SENSITIVE = ['active'];
+// ---------------------------------------------------------------------
+// normalizeConfig
+// ---------------------------------------------------------------------
+/** Materialize every documented default, DEFENSIVELY: a node that is
+ * not the kind it expects is left alone for validate to reject with a
+ * proper message. Pure data-in/data-out, which is what makes it
+ * portable to 22 languages and expressible in the corpus.
+ *
+ * THE NORMALIZED FORM IS AN INPUT TO VALIDATION AND TO NOTHING ELSE. */
+function normalizeConfig(raw) {
+    if (!ismap(raw)) {
+        return raw;
+    }
+    const out = { ...raw };
+    if (undefined === out.station) {
+        out.station = 1;
+    }
+    if (undefined === out.profiles) {
+        out.profiles = {};
+    }
+    if (!ismap(out.profiles)) {
+        return out;
+    }
+    const profiles = {};
+    for (const pname of Object.keys(out.profiles)) {
+        const p = out.profiles[pname];
+        if (!ismap(p)) {
+            profiles[pname] = p;
+            continue;
+        }
+        const prof = { ...p };
+        for (const k of Object.keys(exports.PROFILE_DEFAULTS)) {
+            if (undefined === prof[k]) {
+                prof[k] = exports.PROFILE_DEFAULTS[k]();
+            }
+        }
+        // A `secrets` written without `providers` still gets the chain.
+        if (ismap(prof.secrets) && undefined === prof.secrets.providers) {
+            prof.secrets = { ...prof.secrets, providers: [{ kind: 'env' }] };
+        }
+        prof.feature = normfeatures(prof.feature);
+        for (const bkey of ['api', 'sdk']) {
+            if (!ismap(prof[bkey])) {
+                continue;
+            }
+            const blocks = {};
+            for (const ref of Object.keys(prof[bkey])) {
+                const b = prof[bkey][ref];
+                if (!ismap(b)) {
+                    blocks[ref] = b;
+                    continue;
+                }
+                const block = { ...b };
+                for (const k of Object.keys(exports.BLOCK_DEFAULTS)) {
+                    if (undefined === block[k]) {
+                        block[k] = exports.BLOCK_DEFAULTS[k]();
+                    }
+                }
+                block.feature = normfeatures(block.feature);
+                blocks[ref] = block;
+            }
+            prof[bkey] = blocks;
+        }
+        profiles[pname] = prof;
+    }
+    out.profiles = profiles;
+    return out;
+}
+/** Per feature entry, at every level: `active` -> true.
+ *
+ * A FEATURE NAMED IN THE CONFIG IS ONE YOU ARE ASKING FOR. The SDK's
+ * own default is `active: false` for all but `log`, and
+ * `{"retry": {"retries": 3}}` plainly means "retry, with three
+ * attempts". It also keeps the feature map closed, for the same reason
+ * every other block needs one present key.
+ *
+ * Defensive like the rest: a non-map is returned untouched for validate
+ * to reject by path. */
+function normfeatures(f) {
+    if (!ismap(f)) {
+        return f;
+    }
+    const out = {};
+    for (const name of Object.keys(f)) {
+        const e = f[name];
+        out[name] = ismap(e) && undefined === e.active ? { ...e, active: true } : e;
+    }
+    return out;
+}
+// ---------------------------------------------------------------------
+// validateConfig
+// ---------------------------------------------------------------------
+/** `spec/config-shape.json`, §4.3 verbatim, through the shipped mirror.
+ * Every validate gets a CLONE: struct's validate consumes the spec it
+ * walks (it deletes satisfied `$ONE` branches as it goes), so handing it
+ * the module constant twice would validate the second config against a
+ * spec the first had already eaten. */
+function configShape() {
+    return (0, struct_1.clone)(config_shape_1.CONFIG_SHAPE);
+}
+/** Credential-shaped keys (§5.2). `secret` is here AND is the one
+ * exempt key - see secretvalue below; a blanket deny would reject the
+ * very mechanism that keeps values out of the file. */
+const CREDENTIAL_KEYS = [
+    'apikey', 'auth', 'authorization', 'token',
+    'secret', 'password', 'credential', 'bearer',
+];
+/** The suffix rule catches `access_key`, `X-Api-Token` and friends in
+ * one rule rather than a growing list of spellings. */
+const CREDENTIAL_SUFFIX = ['_KEY', '_TOKEN', '_SECRET', '_PASSWORD'];
+/** §5.2's backstop, and it is stated as one rather than as a grammar.
+ * `validname()` is a NAME grammar, not a credential filter: it rejects
+ * uppercase, hyphens, `+`, `/` and `=`, so it excludes most real
+ * credential formats - but a lowercase hex token passes it cleanly. A
+ * character class cannot tell a name from a secret.
+ *
+ * Derived names break on every separator (`voxgig_solardemo.apikey`
+ * runs 6/9/6) and a hand-written name for a human to read does too; a
+ * 24-character unbroken run is not a name anybody writes. Note this is
+ * a RUN bound, not a length bound: `acme_internal_billing_service.apikey`
+ * is 36 characters and passes, which is the false positive a naive
+ * length bound would produce. */
+const RUN_BOUND = 24;
+const UNBROKEN_RUN = new RegExp('[A-Za-z0-9]{' + RUN_BOUND + ',}');
+/** Normalize, then validate (§4.2). Raises `station_config_invalid`
+ * with EVERY struct error at once - an eighteen-instance config that
+ * touches three of them must not die because the eighteenth has a
+ * typo'd package name - then the §5.2 scans.
+ *
+ * Takes the NORMALIZED form. Handing it a raw config is the mistake
+ * §4.2 exists to prevent, so callers go through open()/loadConfig. */
+function validateConfig(normalized) {
+    const errs = [];
+    (0, struct_1.validate)(normalized, configShape(), { errs });
+    if (0 < errs.length) {
+        throw new error_1.StationError('station_config_invalid', errs.join('; ') + renamehint(normalized));
+    }
+    scanConfig(normalized);
+    return normalized;
+}
+/** `plugin` is REMOVED, not aliased (§3.4) - a deprecated alias would
+ * be a second grammar for one concept in 17 ports. The shape already
+ * rejects it as an unexpected key; this says what to rename, because
+ * "unexpected key: plugin" alone does not, and the migration for a
+ * single-instance project is exactly this one rename. */
+function renamehint(cfg) {
+    const profiles = ismap(cfg) && ismap(cfg.profiles) ? cfg.profiles : {};
+    const hit = Object.keys(profiles)
+        .filter((p) => ismap(profiles[p]) && undefined !== profiles[p].plugin);
+    if (0 === hit.length) {
+        return '';
+    }
+    return '; rename `plugin` to `sdk` in ' +
+        hit.map((p) => 'profiles.' + p).join(', ') +
+        ' - the keys are unchanged, an untagged ref IS an api slug (§3.4)';
+}
+/** The §5.2 scans, over the parts of the grammar that hold arbitrary
+ * data. Everything else is closed by construction and needs no scan. */
+function scanConfig(cfg) {
+    const secrets = [];
+    const reserved = [];
+    const invalid = [];
+    const profiles = ismap(cfg) && ismap(cfg.profiles) ? cfg.profiles : {};
+    for (const pname of Object.keys(profiles)) {
+        const prof = profiles[pname];
+        if (!ismap(prof)) {
+            continue;
+        }
+        const ppath = 'profiles.' + pname;
+        checkfeatures(prof.feature, ppath + '.feature', secrets, reserved, invalid);
+        for (const bkey of ['api', 'sdk']) {
+            if (!ismap(prof[bkey])) {
+                continue;
+            }
+            for (const ref of Object.keys(prof[bkey])) {
+                const block = prof[bkey][ref];
+                if (!ismap(block)) {
+                    continue;
+                }
+                const bpath = ppath + '.' + bkey + '.' + ref;
+                // The block's own `secret` holds a NAME. resolveProfile checks
+                // it again per instance (station_secret_name); this catches it
+                // at open(), for the whole file at once.
+                if (undefined !== block.secret) {
+                    secretvalue(block.secret, bpath + '.secret', secrets);
+                }
+                // `options` is passthrough to a generated constructor, so it is
+                // the one place a value can hide.
+                scan(block.options, bpath + '.options', secrets, reserved);
+                checkfeatures(block.feature, bpath + '.feature', secrets, reserved, invalid);
+                // §4.4's explicit checks, applied where the shape cannot reach,
+                // raising the same code the shape would - and pinned in the
+                // corpus so each workaround is removed deliberately when struct
+                // is fixed rather than forgotten.
+                checkpolicy(block.policy, bpath + '.policy', invalid);
+            }
+        }
+    }
+    if (0 < invalid.length) {
+        throw new error_1.StationError('station_config_invalid', invalid.join('; '));
+    }
+    if (0 < reserved.length) {
+        throw new error_1.StationError('station_feature_reserved', reserved.join('; '));
+    }
+    if (0 < secrets.length) {
+        throw new error_1.StationError('station_config_secret', secrets.join('; '));
+    }
+}
+/** A feature map at any level. `station` is reserved: station composes
+ * its own wrap and a config that reconfigures it is asking for a state
+ * the ordering rules cannot express (§8.4). */
+function checkfeatures(f, path, secrets, reserved, invalid) {
+    if (!ismap(f)) {
+        return;
+    }
+    for (const name of Object.keys(f)) {
+        const fpath = path + '.' + name;
+        if ('station' === name) {
+            reserved.push(path + '.station is reserved: station composes its own ' +
+                'wrap and it cannot be configured from station.json');
+        }
+        const order = ismap(f[name]) ? f[name].order : undefined;
+        if (ismap(order)) {
+            firstelement(order.before, fpath + '.order.before', invalid);
+            firstelement(order.after, fpath + '.order.after', invalid);
+        }
+        scan(f[name], fpath, secrets, reserved);
+    }
+}
+/** The policy block's §4.4 workarounds, in one place because they are
+ * one class of gap: struct cannot check what its own defects hide.
+ *
+ * - `hosts`, `allow.op` and `allow.method` are `$CHILD` string lists,
+ *   so element 0 escapes the shape (see firstelement below).
+ * - `budget` is a map whose keys are ALL optional scalars, and struct
+ *   removes an unsatisfied optional key from the spec node - so
+ *   `budget: {rp: 1}` degenerates the spec into an open map and the
+ *   typo passes. `allow` does not have this problem (its `$CHILD` keys
+ *   stay in the spec whether or not the data carries them, keeping the
+ *   map closed), and neither does `policy` itself (`hosts` anchors it);
+ *   `budget` alone needs the explicit unexpected-key check, phrased as
+ *   struct would phrase it. */
+const BUDGET_KEYS = ['concurrency', 'rps'];
+function checkpolicy(policy, path, invalid) {
+    if (!ismap(policy)) {
+        return;
+    }
+    firstelement(policy.hosts, path + '.hosts', invalid);
+    const allow = policy.allow;
+    if (ismap(allow)) {
+        firstelement(allow.op, path + '.allow.op', invalid);
+        firstelement(allow.method, path + '.allow.method', invalid);
+    }
+    const budget = policy.budget;
+    if (ismap(budget)) {
+        const unknown = Object.keys(budget)
+            .filter((k) => !BUDGET_KEYS.includes(k)).sort();
+        if (0 < unknown.length) {
+            invalid.push('Unexpected keys at field ' + path + '.budget: ' +
+                unknown.join(', '));
+        }
+    }
+}
+/** §4.4: `$CHILD` in list mode DOES NOT VALIDATE ELEMENT 0. Verified:
+ * `["a", 1]` fails at index 1, `[1]` passes. validate_CHILD installs the
+ * template across the data's indices, sets keyI = 0 and returns element
+ * 0 as the slot value, and the injection loop resumes past it. An
+ * upstream struct defect; filing it is a deliverable of this plan.
+ *
+ * It reaches EVERY string list in the shape. §4.4 says the only one left
+ * is `policy.hosts` because the profile-level `order` list is gone - but
+ * §8.4's per-feature `order` carries `before`/`after` string lists, so
+ * the reach is three lists, not one, and §4.5 pins `order: [7]`
+ * accordingly. Applied where the shape cannot reach, raising the same
+ * code the shape would, and pinned in the corpus so the workaround is
+ * removed deliberately when struct is fixed rather than forgotten. */
+function firstelement(list, path, invalid) {
+    if (!Array.isArray(list) || 0 === list.length) {
+        return;
+    }
+    if ('string' === typeof list[0]) {
+        return;
+    }
+    invalid.push('Expected field ' + path + '.0 to be string, but found ' +
+        kindof(list[0]) + ': ' + JSON.stringify(list[0]));
+}
+/** Recursive over EVERY nested map and list, not just the top level -
+ * a credential one level down is the case a top-level scan misses. */
+function scan(node, path, secrets, reserved) {
+    if (Array.isArray(node)) {
+        for (let i = 0; i < node.length; i++) {
+            scan(node[i], path + '.' + i, secrets, reserved);
+        }
+        return;
+    }
+    if ('string' === typeof node) {
+        userinfo(node, path, secrets);
+        return;
+    }
+    if (!ismap(node)) {
+        return;
+    }
+    for (const key of Object.keys(node)) {
+        const kpath = path + '.' + key;
+        const val = node[key];
+        // §8.6: station owns feature composition, so an `options.feature`
+        // in a declarative config is a second, unreconciled ordering input.
+        if ('feature' === key) {
+            reserved.push(kpath + ' is reserved: configure features under the ' +
+                'block\'s own `feature` key, not through `options`');
+            continue;
+        }
+        if ('secret' === key.toLowerCase()) {
+            secretvalue(val, kpath, secrets);
+            continue;
+        }
+        if (credentialkey(key)) {
+            secrets.push(kpath + ' is a credential-shaped key: station.json ' +
+                'holds secret NAMES, never values (§5.2)');
+            continue;
+        }
+        scan(val, kpath, secrets, reserved);
+    }
+}
+function credentialkey(key) {
+    const low = String(key).toLowerCase().replace(/[^a-z0-9]+/g, '');
+    if (CREDENTIAL_KEYS.includes(low)) {
+        return true;
+    }
+    const tok = (0, descriptor_1.envtoken)(key);
+    return CREDENTIAL_SUFFIX.some((s) => tok.endsWith(s));
+}
+/** A `secret`-named key holds a NAME, and that exemption is not a
+ * loophole - it is the whole design. Two checks, not one, and they live
+ * in the same three lines precisely so a port cannot implement only the
+ * first and inherit the gap the second exists to close. */
+function secretvalue(val, path, secrets) {
+    if ('string' !== typeof val) {
+        secrets.push(path + ' must be a secret name (a string), but found ' +
+            kindof(val));
+        return;
+    }
+    if (!(0, sekreto_1.validname)(val)) {
+        secrets.push(path + ' is not a valid sekreto name, so it cannot be a ' +
+            'name and must not be a value: ' + JSON.stringify(val));
+        return;
+    }
+    if (UNBROKEN_RUN.test(val)) {
+        secrets.push(path + ' contains an unbroken alphanumeric run of ' +
+            RUN_BOUND + ' or more characters, which is not a name anybody writes');
+    }
+}
+/** One rule about values rather than keys, because the `proxy` feature
+ * makes it concrete: `http://user:pass@proxy.internal:8080`. */
+function userinfo(val, path, secrets) {
+    if (!/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(val)) {
+        return;
+    }
+    let u;
+    try {
+        u = new URL(val);
+    }
+    catch (e) {
+        return;
+    }
+    if ('' !== u.username || '' !== u.password) {
+        secrets.push(path + ' is a URL carrying userinfo, which puts a ' +
+            'credential in the config file; use the proxy feature\'s ' +
+            '`fromEnv` option instead (§8.6)');
+    }
+}
+function kindof(v) {
+    if (null === v) {
+        return 'null';
+    }
+    if (Array.isArray(v)) {
+        return 'list';
+    }
+    if ('number' === typeof v) {
+        return Number.isInteger(v) ? 'integer' : 'decimal';
+    }
+    return typeof v;
+}
+function ismap(v) {
+    return null != v && 'object' === typeof v && !Array.isArray(v);
+}
+//# sourceMappingURL=shape.js.map

package/dist/src/shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.js","sourceRoot":"","sources":["../../src/shape.ts"],"names":[],"mappings":"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"}

package/dist/src/types.d.ts

@@ -0,0 +1,138 @@
+export type StationOptions = {
+    profile?: string;
+    proxy?: 'auto' | 'off' | 'require' | string;
+    folder?: string;
+    config?: StationConfig | null;
+    load?: boolean;
+    repoScoped?: boolean;
+};
+export type StationConfig = {
+    station: number;
+    profiles?: Record<string, Profile>;
+};
+export type Profile = {
+    secrets?: {
+        providers?: any[];
+    };
+    feature?: Record<string, any>;
+    api?: Record<string, SdkBlock>;
+    sdk?: Record<string, SdkBlock>;
+};
+export type PolicyBlock = {
+    hosts?: string[];
+    allow?: {
+        op?: string[];
+        method?: string[];
+    };
+    budget?: {
+        rps?: number;
+        concurrency?: number;
+    };
+    mode?: 'live' | 'record' | 'replay' | 'mock' | 'block';
+};
+export type SdkBlock = {
+    package?: string;
+    export?: string;
+    base?: string;
+    secret?: string;
+    resolve?: 'library' | 'proxy';
+    policy?: PolicyBlock;
+    capture?: 'meta' | 'headers' | 'full';
+    agent?: {
+        write: boolean;
+    };
+    feature?: Record<string, any>;
+    options?: Record<string, any>;
+    active?: boolean;
+};
+export type Descriptor = {
+    station: 1;
+    name: string;
+    slug: string;
+    envtoken: string;
+    version: string;
+    target: string;
+    base: string;
+    server: {
+        name: string;
+        value: string;
+    }[];
+    auth: {
+        active: boolean;
+        prefix: string;
+        secretname: string;
+    };
+    entities: Record<string, DescriptorEntity>;
+    features: {
+        name: string;
+        active: boolean;
+        options?: Record<string, any>;
+        transport?: string;
+    }[];
+};
+export type DescriptorEntity = {
+    fields: Record<string, {
+        kind: string;
+    }>;
+    ops: Record<string, {
+        points: DescriptorPoint[];
+    }>;
+};
+export type DescriptorPoint = {
+    method: string;
+    path: string;
+    params: string[];
+    select?: Record<string, any>;
+};
+export type StationEvent = {
+    t: number;
+    plugin?: string;
+    api?: string;
+    corr?: string;
+    kind: 'construct' | 'op' | 'http' | 'error' | 'feature' | 'station';
+    op?: {
+        entity: string;
+        op: string;
+        outcome: string;
+        durationMs: number;
+    };
+    http?: {
+        method: string;
+        host: string;
+        path: string;
+        status: number;
+        durationMs: number;
+        bytes: number;
+    };
+    err?: {
+        code?: string;
+        status?: number;
+        message: string;
+    };
+    meta?: Record<string, any>;
+};
+export type Binding = {
+    plugin: string;
+    instance?: string;
+    base?: string;
+    placeholder?: string;
+    secretname?: string;
+    rung: 'none' | 'R1';
+};
+export type PluginEntry = {
+    name: string;
+    api: string;
+    descriptor: Descriptor;
+    rung: 'none' | 'R1';
+    client: any;
+    warnings: string[];
+    secretname?: string;
+};
+export type ResolvedInstance = {
+    name: string;
+    api: string;
+    active: boolean;
+    live: boolean;
+    rung: 'none' | 'R1';
+    block: SdkBlock;
+};

package/dist/src/types.js

@@ -0,0 +1,5 @@
+"use strict";
+// Shared station types. Descriptor and StationEvent shapes are pinned by
+// the conformance corpus (spec/station.json) - evolve them additively.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@voxgig/station",
+  "version": "0.0.1",
+  "description": "station: one control surface for outbound integrations (TypeScript, canonical)",
+  "main": "dist/src/index.js",
+  "type": "commonjs",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "browser": "./dist/src/index.browser.js",
+      "default": "./dist/src/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "homepage": "https://github.com/voxgig/station",
+  "keywords": [
+    "voxgig",
+    "station",
+    "sdk",
+    "integration",
+    "api-client",
+    "plugins"
+  ],
+  "author": "",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/voxgig/station.git"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist coverage node_modules package-lock.json",
+    "test": "npm run build && node --test \"dist/test/*.test.js\"",
+    "test-some": "npm run build && node --test --test-name-pattern=$npm_config_pattern \"dist/test/*.test.js\"",
+    "watch": "tsc -w",
+    "typecheck": "tsc --noEmit",
+    "reset": "npm run clean && npm i && npm run build && npm test",
+    "repo-tag": "REPO_VERSION=`node -e \"console.log(require('./package').version)\"` && echo TAG: typescript/v$REPO_VERSION && git commit -a -m typescript/v$REPO_VERSION && git push && git tag typescript/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 stage publish --access public --registry https://registry.npmjs.org",
+    "repo-publish-dry": "npm run clean && npm i && npm run repo-publish-dry-quick",
+    "repo-publish-dry-quick": "npm run build && npm run test && npm stage publish --dry-run --access public --registry https://registry.npmjs.org"
+  },
+  "license": "MIT",
+  "files": [
+    "LICENSE",
+    "src",
+    "!src/omnihome.*",
+    "dist/src",
+    "!dist/src/omnihome.*"
+  ],
+  "dependencies": {
+    "@voxgig/sekreto": "^0.1.0",
+    "@voxgig/struct": "^0.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  }
+}