declapract-typescript-ehmpathy 0.49.13 → 0.49.14

package/dist/.test/assets/expo-fullusecase/declarations/practices/conventional-commits/best-practice/.husky/commit-msg

@@ -1,8 +0,0 @@
-#!/bin/sh
-if [ ! -f "$(dirname -- "$0")/_/husky.sh" ]; then
-  echo "🟡 husky not available, skipping hook"
-  exit 0
-fi
-. "$(dirname -- "$0")/_/husky.sh"
-
-. "$(dirname -- "$0")/check.commit.sh"

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/old-acceptance-dir-location/.test/assets/demo-repo-with-accept-blackbox-dir/declapract.declare.yml

@@ -1,4 +0,0 @@
-declare:
-  examples: src/examples
-  practices: src/practices
-  use-cases: src/useCases.yml

package/dist/.test/assets/expo-migration/declarations/practices/cicd-app-react-native-expo/best-practice/.github/workflows/test.yml

@@ -1,25 +0,0 @@
-name: test
-
-on:
-  workflow_call:
-  push:
-    branches-ignore:
-      - 'main' # exclude main branch, since deploy workflow triggers on main, and calls the test workflow inside of it already
-    tags-ignore:
-      - v* # exclude tags, since deploy workflow triggers on tags, and calls the test workflow inside of it already
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }} # per [workflow] x [branch, tag]
-  cancel-in-progress: true #  cancel workflows for non-latest commits
-
-permissions:
-  id-token: write # required for oidc; a called workflow cannot exceed its caller's grant
-  contents: read
-
-jobs:
-  suite:
-    uses: ./.github/workflows/.test.yml
-    with:
-      creds-aws-region: us-east-1
-      creds-aws-role-arn: ${{ vars.CREDS_CICD_AWS_PREP_OIDC_ROLE_ARN }} # use aws auth via oidc, if this repo supplies it
-    secrets: inherit # keyrack firewall in .test.yml filters to declared keys

package/dist/.test/assets/expo-migration/declarations/practices/tests-any/bad-practices/old-acceptance-dir-location/.test/assets/demo-repo-with-accept-blackbox-dir/declapract.declare.yml

@@ -1,4 +0,0 @@
-declare:
-  examples: src/examples
-  practices: src/practices
-  use-cases: src/useCases.yml

package/dist/.test/assets/expo-toolchain/declarations/practices/tests-any/bad-practices/old-acceptance-dir-location/.test/assets/demo-repo-with-accept-blackbox-dir/declapract.declare.yml

@@ -1,4 +0,0 @@
-declare:
-  examples: src/examples
-  practices: src/practices
-  use-cases: src/useCases.yml

package/dist/.test/assets/format/declarations/practices/terraform-common/best-practice/package.json

@@ -1,6 +0,0 @@
-{
-  "scripts": {
-    "fix:format:terraform": "terraform fmt -recursive provision",
-    "test:format:terraform": "terraform fmt -recursive -check provision"
-  }
-}

package/dist/practices/cicd-app-react-native-expo/best-practice/.github/workflows/test.yml

@@ -1,25 +0,0 @@
-name: test
-
-on:
-  workflow_call:
-  push:
-    branches-ignore:
-      - 'main' # exclude main branch, since deploy workflow triggers on main, and calls the test workflow inside of it already
-    tags-ignore:
-      - v* # exclude tags, since deploy workflow triggers on tags, and calls the test workflow inside of it already
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }} # per [workflow] x [branch, tag]
-  cancel-in-progress: true #  cancel workflows for non-latest commits
-
-permissions:
-  id-token: write # required for oidc; a called workflow cannot exceed its caller's grant
-  contents: read
-
-jobs:
-  suite:
-    uses: ./.github/workflows/.test.yml
-    with:
-      creds-aws-region: us-east-1
-      creds-aws-role-arn: ${{ vars.CREDS_CICD_AWS_PREP_OIDC_ROLE_ARN }} # use aws auth via oidc, if this repo supplies it
-    secrets: inherit # keyrack firewall in .test.yml filters to declared keys

package/dist/practices/config/best-practice/provision/aws/product/variables.tf

@@ -1,3 +0,0 @@
-locals {
-  service      = "@declapract{variable.projectName}"
-}

package/dist/practices/config/best-practice/src/utils/environment.ts

@@ -1,9 +0,0 @@
-// note = a placeholder boundary. this practice only checks that the file EXISTS (it never
-//        checks its contents); the `environments` practice is the sole real declarer of
-//        `src/utils/environment.ts` and supplies the typed exports. this stub exists solely so
-//        the declared acceptance test file type-checks in a consumer that has `config` but not
-//        yet `environments`. removal path = when a consumer converges the `environments`
-//        practice, its real file overwrites this stub. the exports are typed `string` — no cast:
-//        the real `access` export is a tier string, so `string` is the honest widened type here
-//        and needs no `as`.
-export const access: string = 'placeholder';

package/dist/practices/config/best-practice/src/utils/environment.ts.declapract.ts

@@ -1,11 +0,0 @@
-import { FileCheckType } from 'declapract';
-
-/**
- * .what = an EXISTS-only check on `src/utils/environment.ts`.
- * .why = the `environments` practice, not `config`, authors the real `environment.ts`. this
- *        practice only asserts the file is present. under BEST_PRACTICE purpose an EXISTS check
- *        resolves `fix: null` (see declapract's getFileCheckDeclaration), so the peer template's
- *        `as any` placeholder body is never written to a consumer — the contents are structurally
- *        unreachable. safe to leave until the tracked CONTAINS-over-real-exports cleanup lands (D55).
- */
-export const check = FileCheckType.EXISTS;

package/dist/practices/conventional-commits/best-practice/.husky/check.commit.sh

@@ -1,7 +0,0 @@
-#!/bin/bash
-
-if command -v node > /dev/null 2>&1 && [ -x ./node_modules/.bin/commitlint ]; then
-    ./node_modules/.bin/commitlint --edit "$1"
-else
-    echo "🟡 commitlint not available, wont check commit message"
-fi

package/dist/practices/conventional-commits/best-practice/.husky/commit-msg

@@ -1,8 +0,0 @@
-#!/bin/sh
-if [ ! -f "$(dirname -- "$0")/_/husky.sh" ]; then
-  echo "🟡 husky not available, skipping hook"
-  exit 0
-fi
-. "$(dirname -- "$0")/_/husky.sh"
-
-. "$(dirname -- "$0")/check.commit.sh"

package/dist/practices/dates-and-times/bad-practices/moment/package.json.declapract.ts

@@ -1,12 +0,0 @@
-import type { FileCheckFunction } from 'declapract';
-import expect from 'expect';
-
-export const check: FileCheckFunction = (contents) => {
-  expect(JSON.stringify(contents ?? 'null')).toMatchObject(
-    expect.objectContaining({
-      dependencies: expect.objectContaining({
-        moment: expect.any(String),
-      }),
-    }),
-  );
-};

package/dist/practices/lint-react-native/best-practice/.eslintrc.js

@@ -1,57 +0,0 @@
-module.exports = {
-  parser: '@typescript-eslint/parser', // Specifies the ESLint parser
-  extends: [
-    'plugin:@typescript-eslint/recommended', // Uses the recommended rules from the @typescript-eslint/eslint-plugin
-    'plugin:import/recommended', // specifies good import rules
-    'airbnb-typescript/base', // uses the airbnb recommended rules
-    'plugin:react/recommended',
-    'plugin:react-hooks/recommended',
-    'plugin:jsx-a11y/recommended',
-    'plugin:prettier/recommended', // Enables eslint-plugin-prettier and displays prettier errors as ESLint errors. Make sure this is always the last configuration in the extends array.
-  ],
-  parserOptions: {
-    project: './tsconfig.json',
-    ecmaVersion: 2018, // Allows for the parsing of modern ECMAScript features
-    sourceType: 'module', // Allows for the use of imports
-  },
-  rules: {
-    'import/extensions': 'off', // too many false positives; should figure out why
-    'react/react-in-jsx-scope': 'off', // https://stackoverflow.com/a/68315971/3068233
-    'react/no-unescaped-entities': 'off', // too invasive -> not seeing the value either
-    '@typescript-eslint/explicit-function-return-type': 'off', // this can be figured out implicitly, and that is better
-    'sort-imports': 'off',
-    'import/prefer-default-export': 'off', // default export = bad
-    'import/no-default-export': 'error', // require named exports - they make it easier to refactor, enforce consistency, and increase constraints
-    '@typescript-eslint/no-non-null-assertion': 'off', // we use these to help typescript out when we know something it doesnt, and cant easily express that
-    'import/no-extraneous-dependencies': [
-      'error',
-      {
-        devDependencies: [
-          '**/*.test.ts',
-          '**/*.test.integration.ts',
-          '**/*.test.acceptance.ts',
-          'acceptance/**/*.ts',
-          '**/__test_utils__/**/*.ts',
-          'provision/**/*.ts',
-        ],
-      },
-    ],
-    '@typescript-eslint/no-explicit-any': 'off', // sometimes this is a valid definition
-    '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
-    'import/no-cycle': 'off',
-    'max-classes-per-file': 'off',
-    '@typescript-eslint/no-use-before-define': 'off',
-    '@typescript-eslint/no-floating-promises': 'error',
-    'prefer-destructuring': 'off',
-    '@typescript-eslint/no-non-null-assertion': 'off',
-    'lines-between-class-members': 'off',
-    '@typescript-eslint/lines-between-class-members': 'off',
-    'no-return-await': 'off', // this does not help anything and actually leads to bugs if we subsequently wrap the return in a try catch without remembering to _then_ add await
-    '@typescript-eslint/return-await': 'off',
-    '@typescript-eslint/no-unsafe-declaration-merging': 'off',
-    '@typescript-eslint/default-param-last': 'off', // interferes with input vs context
-  },
-  settings: {
-    'import/ignore': ['react-native'], // https://github.com/facebook/react-native/issues/28549
-  },
-};

package/dist/practices/persist-with-dynamodb/.test/assets/demo-repo-with-divergent-jest-env/declapract.declare.yml

@@ -1,4 +0,0 @@
-declare:
-  examples: src/examples
-  practices: src/practices
-  use-cases: src/useCases.yml

package/dist/practices/persist-with-dynamodb/.test/assets/demo-repo-with-divergent-jest-env/declapract.use.yml

@@ -1,2 +0,0 @@
-declarations: './'
-useCase: lambda-service-with-dynamodb

package/dist/practices/persist-with-dynamodb/.test/assets/demo-repo-with-divergent-jest-env/jest.integration.env.ts

@@ -1,4 +0,0 @@
-import { access } from './src/utils/environment';
-
-if (access === 'test')
-  process.env.USE_CUSTOM_DYNAMODB_ENDPOINT = 'http://localhost:9999';

package/dist/practices/persist-with-dynamodb/best-practice/jest.integration.env.ts

@@ -1,7 +0,0 @@
-import { access } from './src/utils/environment';
-
-/**
- * specify that dynamodb should use the local dynamodb database, under the test access
- */
-if (access === 'test')
-  process.env.USE_CUSTOM_DYNAMODB_ENDPOINT = 'http://localhost:7337';

package/dist/practices/persist-with-dynamodb/best-practice/provision/aws/environments/test/main.tf

@@ -1,3 +0,0 @@
-endpoints {
-  dynamodb = "http://localhost:7337/"
-}

package/dist/practices/persist-with-dynamodb/best-practice/provision/aws/environments/test/main.tf.declapract.ts

@@ -1,3 +0,0 @@
-import { FileCheckType } from 'declapract';
-
-export const check = FileCheckType.CONTAINS; // should contain specifier that test applies to local dynamodb

package/dist/practices/persist-with-rds/__snapshots__/ssm-cicd-param-names.declapract.integration.test.ts.snap

@@ -1,10 +0,0 @@
-// Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
-
-exports[`persist-with-rds ssm cicd param names are slash-path, tierless given: [case1] the two cicd credentials when: [t0] resources.parameters.ts is read then: the emitted cicd + crud param-name lines match snapshot: ssm cicd + crud param names 1`] = `
-[
-  "*         with NO tier segment — \`parameter/<star>/svc-<star>/database/role/cicd/for-plan/<star>\`",
-  "secret({ name: \`\${namespace}.database.role.crud.password\` }),",
-  "name: \`/@declapract{variable.organizationName}/@declapract{variable.projectName}/database/role/cicd/for-plan/password\`,",
-  "name: \`/@declapract{variable.organizationName}/@declapract{variable.projectName}/database/role/cicd/for-apply/password\`,",
-]
-`;

package/dist/practices/persist-with-rds/bad-practices/with-connection-in-input/src/utils/database/withDatabaseConnection.ts

@@ -1,3 +0,0 @@
-import { FileCheckType } from 'declapract';
-
-export const check = FileCheckType.EXISTS; // if a file exists with this path pattern, then it's bad practice

package/dist/practices/persist-with-rds/ssm-cicd-param-names.declapract.integration.test.ts

@@ -1,73 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
-
-import { given, then, when } from 'test-fns';
-
-/**
- * .what = clamps that the ssm-off-terraform wish declares the two cicd credentials as SLASH paths
- *         with NO tier segment, while the crud credential keeps its dotted tier-scoped name.
- * .why  = the prod plan role pins its ONE `kms:Decrypt` exception to a slash arn
- *         (`parameter/*​/svc-*​/database/role/cicd/for-plan/*`) that needs literal `/` separators
- *         and omits a tier (the aws ACCOUNT separates prep from prod, never the name). a dotted
- *         name cannot match that arn, so the plan role gets ciphertext or a denial, forever, and
- *         a repo does not find out until prod (#591). the shipped `ahbode/svc-home-services` proved
- *         the slash form; this clamp ports it into the practice so no consumer inherits the dotted
- *         cicd name again. crud is pinned by NO policy, so it keeps its dotted name and this clamp
- *         leaves it alone.
- * .teeth = revert either cicd entry to the dotted `${namespace}.database.role.cicd.for-plan.password`
- *          form and the slash-present case reddens; the no-dotted-cicd case reddens too.
- * .note = `.declapract.test.ts` = this repo's UNIT-test marker; at the practice ROOT (not under
- *         best-practice/), so it is neither loaded as a declaration nor copied to a consumer.
- */
-
-// anchor on __dirname, not process.cwd(): a nested `jest src/practices/...` run has a different cwd.
-// from this file (src/practices/persist-with-rds/) the best-practice tree is one segment down.
-const paramsPath = join(
-  __dirname,
-  'best-practice/provision/aws/resources.parameters.ts',
-);
-
-describe('persist-with-rds ssm cicd param names are slash-path, tierless', () => {
-  const source = readFileSync(paramsPath, 'utf8');
-
-  given('[case1] the two cicd credentials', () => {
-    when('[t0] resources.parameters.ts is read', () => {
-      then('for-plan is a slash path, byte-identical to the iam pin', () => {
-        expect(source).toContain('/database/role/cicd/for-plan/password');
-      });
-
-      then('for-apply is a slash path', () => {
-        expect(source).toContain('/database/role/cicd/for-apply/password');
-      });
-
-      then('neither cicd name is dotted (a dotted name cannot match the arn pin)', () => {
-        expect(source).not.toContain('.database.role.cicd.for-plan');
-        expect(source).not.toContain('.database.role.cicd.for-apply');
-      });
-
-      then('the cicd slash path carries no tier segment (project joins /database directly)', () => {
-        // /{org}/{project}/database/... — a tier segment would split project from database
-        expect(source).toContain('projectName}/database/role/cicd/for-plan/password');
-        expect(source).not.toContain('${slug}/database/role/cicd');
-      });
-
-      // the emitted param-name lines are the caller-faced contract: snapshot them so a reword that
-      // keeps the slash tokens green (a re-templated prefix, a moved tier segment) reddens a vibecheck.
-      then('the emitted cicd + crud param-name lines match snapshot', () => {
-        const nameLines = source
-          .split('\n')
-          .filter((line) => line.includes('database/role/cicd') || line.includes('database.role.'))
-          .map((line) => line.trim());
-        expect(nameLines).toMatchSnapshot('ssm cicd + crud param names');
-      });
-    });
-  });
-
-  given('[case2] the crud credential', () => {
-    when('[t0] resources.parameters.ts is read', () => {
-      then('crud keeps its dotted tier-scoped name (no policy pins it)', () => {
-        expect(source).toContain('${namespace}.database.role.crud.password');
-      });
-    });
-  });
-});

package/dist/practices/terraform-common/best-practice/package.json

@@ -1,6 +0,0 @@
-{
-  "scripts": {
-    "fix:format:terraform": "terraform fmt -recursive provision",
-    "test:format:terraform": "terraform fmt -recursive -check provision"
-  }
-}

package/dist/practices/tests-any/bad-practices/old-acceptance-dir-location/.test/assets/demo-repo-with-accept-blackbox-dir/declapract.declare.yml

@@ -1,4 +0,0 @@
-declare:
-  examples: src/examples
-  practices: src/practices
-  use-cases: src/useCases.yml