@ojiepermana/angular-sdk 22.0.27

package/README.md

@@ -0,0 +1,252 @@
+# SDK Generator
+
+OpenAPI → Angular SDK generator shipped as the secondary entrypoint
+`@ojiepermana/angular/generator/api`.
+
+It generates a **lightweight Angular SDK** from any OpenAPI 3.x spec (including
+3.2.0): typed `HttpClient` services, tree-shakeable fn modules, optional
+metadata (permissions / validators), and a navigation tree.
+
+## Local development in this repo
+
+```bash
+# 1. Build the schematic runtime
+bun run gen:sdk:build
+
+# 2. Scaffold a workspace config
+bun run gen:sdk:init
+
+# 3. Edit sdk.config.json, then generate
+bun run gen:sdk
+
+# 4. Run the split-by-domain regression checks
+bun run test:gen:sdk
+```
+
+## Consumer usage after publish
+
+```bash
+# inside an Angular workspace that installed @ojiepermana/angular
+ng generate @ojiepermana/angular:sdk-init
+# edit config/sdk.config.json
+ng generate @ojiepermana/angular:sdk
+```
+
+The main consumer feature is generating an SDK from
+`config/sdk.config.json`. The consumer flow is: initialize the config once,
+edit it, then run `sdk` whenever the OpenAPI source changes.
+
+If a consumer wants short script aliases in `package.json`, they can add this
+script block to their workspace:
+
+```json
+{
+  "scripts": {
+    "gen:sdk:init": "ng generate @ojiepermana/angular:sdk-init",
+    "gen:sdk": "ng generate @ojiepermana/angular:sdk"
+  }
+}
+```
+
+Consumers do not need a `gen:sdk:build` step. That build command only exists
+for developing this repository, where the schematic source under
+`projects/angular/generator/api` must be compiled before local execution.
+
+## Schematics
+
+The entrypoint exposes two schematics, registered in the parent collection at [`projects/angular/collection.json`](../../collection.json):
+
+| Schematic  | Script                 | Purpose                                          |
+| ---------- | ---------------------- | ------------------------------------------------ |
+| `sdk-init` | `bun run gen:sdk:init` | Create `config/sdk.config.json` from the example |
+| `sdk`      | `bun run gen:sdk`      | Run the generator using `config/sdk.config.json` |
+
+Both can be invoked directly with `ng generate` too:
+
+```bash
+bunx ng generate ./projects/angular/collection.json:sdk-init [--force] [--path=custom/sdk.config.json]
+bunx ng generate ./projects/angular/collection.json:sdk      [--dry-run] [--config=sdk.config.json] [--target=1]
+
+# after publish / inside a consuming workspace:
+ng generate @ojiepermana/angular:sdk-init [--force] [--path=custom/sdk.config.json]
+ng generate @ojiepermana/angular:sdk      [--dry-run] [--config=sdk.config.json] [--target=1]
+```
+
+### `init` options
+
+| Option    | Type    | Default                  | Description                                   |
+| --------- | ------- | ------------------------ | --------------------------------------------- |
+| `--path`  | string  | `config/sdk.config.json` | Destination path, relative to workspace root. |
+| `--force` | boolean | `false`                  | Overwrite the file if it already exists.      |
+
+### `sdk` options
+
+| Option      | Type   | Default                  | Description                                                        |
+| ----------- | ------ | ------------------------ | ------------------------------------------------------------------ |
+| `--config`  | string | `config/sdk.config.json` | Path to the config file, relative to workspace root.               |
+| `--target`  | string | _(all)_                  | Only generate one target. Accepts a 1-based index or `clientName`. |
+| `--dry-run` | flag   | —                        | Preview file operations without writing anything.                  |
+
+## Config shape
+
+```jsonc
+{
+  "$schema": "./node_modules/@ojiepermana/angular/generator/api/schematics/sdk/schema.json",
+  "targets": [
+    {
+      "input": "./openapi.yaml",
+      "output": "./sdk",
+      "mode": "library", // "standalone" | "library" | "secondary-entrypoint"
+      "clientName": "Api",
+      "packageName": "@my-scope/sdk", // used in "library" mode
+      "packageVersion": "0.0.1", // used in "library" mode
+      "rootUrl": "", // optional; empty string means same-origin requests
+      "splitByDomain": true, // optional; defaults true for "library", false otherwise
+      "splitDepth": "service", // "service" (default) | "tag"
+      "features": {
+        "models": true,
+        "operations": true,
+        "services": true,
+        "client": true,
+        "metadata": true,
+        "navigation": true,
+      },
+    },
+  ],
+}
+```
+
+Multiple targets are supported — one config run can emit several SDKs.
+
+If `rootUrl` is omitted or left empty, the generated SDK uses same-origin
+requests by default. Consumer apps can override it at runtime with
+`provideApiConfiguration(...)`.
+
+### Runtime base URL
+
+The generated SDK does not read `sdk.config.json` at runtime. The value of
+`targets[].rootUrl` is only used during code generation to seed the default
+`ApiConfiguration.rootUrl` value.
+
+- `rootUrl: ""` or omitted: requests use the current origin, for example
+  `/api/users` on the same host as the Angular app.
+- `rootUrl: "https://api.example.com"`: the generated SDK defaults to that
+  absolute backend URL.
+- Runtime override: consumer apps can replace the default by providing a new
+  value during bootstrap.
+
+Example runtime override in a consumer app:
+
+```ts
+import { bootstrapApplication } from '@angular/platform-browser';
+import { provideHttpClient } from '@angular/common/http';
+
+import { AppComponent } from './app/app.component';
+import { provideApiConfiguration } from '@my-scope/sdk';
+
+bootstrapApplication(AppComponent, {
+  providers: [provideHttpClient(), provideApiConfiguration('https://api.example.com')],
+});
+```
+
+For standalone generated output inside the same workspace, import
+`provideApiConfiguration` from the generated SDK barrel instead of an npm
+package path.
+
+## Per-domain layout
+
+By default, standalone and secondary-entrypoint targets emit a flat layout
+(`models/`, `fn/`, `services/`, … all at the output root). `mode: "library"`
+defaults to `splitByDomain: true` so the generated package is split into
+secondary entrypoints immediately. You can still set `splitByDomain: false` if
+you need the older flat library shape. Cross-domain models and client primitives
+land in `shared/`.
+
+```jsonc
+{
+  "splitByDomain": true,
+  "splitDepth": "service", // or "tag"
+}
+```
+
+`splitDepth` controls granularity. It is only read when `splitByDomain` is
+`true`.
+
+| `splitDepth` | Folder strategy                                                                                                  | Example (spec with tags `Access/Role`, `Access/Permission`, `Storage/GCS`, `Storage/S3`, `Auth`)                                         |
+| ------------ | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `service`    | One folder per **root** tag (each tag's `parent` chain collapses to its root). One folder per backend service.   | `access/` (holds Role + Permission + Role-Permission + …), `storage/` (holds GCS + S3), `auth/`, `shared/`, root `public-api.ts`         |
+| `tag`        | One folder per **leaf** tag, nested under the parent chain. Keeps fine-grained separation while staying grouped. | `access/role/`, `access/permission/`, `access/role-permission/`, `storage/gcs/`, `storage/s3/`, `auth/`, `shared/`, root `public-api.ts` |
+
+Every domain folder contains `services/`, `fn/`, `models/`, `permissions/`,
+and its own `public-api.ts`. The root still owns the aggregate metadata barrel:
+`metadata.ts`, `openapi-helpers.ts`, and `permissions/index.ts` stay at the SDK
+root so `shared/` never depends on sibling domains. In standalone and
+secondary-entrypoint modes, the root `public-api.ts` aggregates `shared`, root
+metadata helpers, and every domain for convenience. In library mode, domain
+exports stay in their secondary entrypoints so consumers deep import the domain
+they need.
+
+Model ownership rule (per-domain mode):
+
+- A model used by exactly one domain → emitted inside that domain's `models/`.
+- A model shared across two or more domains → emitted inside `shared/models/`.
+- Client primitives (`ApiConfiguration`, `BaseService`, `RequestBuilder`,
+  `StrictHttpResponse`, `Api`), shared metadata types, validators, and
+  navigation always live under `shared/`.
+- Aggregate metadata helpers (`metadata.ts`, `openapi-helpers.ts`) and the
+  top-level `permissions/index.ts` stay at the SDK root.
+
+Example consumption when using `mode: 'library'`:
+
+```ts
+import { RoleService } from '@my-scope/sdk/access';
+import { ApprovalInstanceService, SubmitRequest } from '@my-scope/sdk/approval';
+import { GCSService } from '@my-scope/sdk/storage'; // splitDepth: 'service'
+import { GCSService } from '@my-scope/sdk/storage/gcs'; // splitDepth: 'tag'
+```
+
+## Output modes
+
+| Mode                   | What it emits                                                                                                                                                      | Use when…                                                                              |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
+| `standalone`           | A plain folder (no `ng-package.json`).                                                                                                                             | You consume the SDK via path alias / `tsconfig.paths` inside the same app.             |
+| `library`              | Split-by-domain output plus package metadata and nested `ng-package.json` manifests for secondary entrypoints.                                                     | You want a buildable/publishable Angular package with efficient deep imports.          |
+| `secondary-entrypoint` | Standalone output **plus** a minimal `ng-package.json` pointing at `public-api.ts`, plus nested `ng-package.json` files for split-by-domain secondary entrypoints. | You drop the folder inside an existing library so ng-packagr picks it up as a subpath. |
+
+In `library` mode, output also includes `tsconfig.lib.json` and `tsconfig.lib.prod.json`.
+`ng-package.dest` defaults to `dist/<output-folder-name>`.
+
+## Feature flags
+
+All default to `true`. Turn off anything you don't need to shrink the output.
+
+| Flag         | Emits                                                                                      |
+| ------------ | ------------------------------------------------------------------------------------------ |
+| `models`     | `models/*.ts` — flat interfaces, enum aliases, array aliases.                              |
+| `operations` | `fn/<tag>/<operation-id>.ts` — tree-shakeable request functions with `.PATH`.              |
+| `services`   | `services/<tag>.service.ts` — `@Injectable({providedIn:'root'})` wrappers.                 |
+| `client`     | `api-configuration.ts`, `base-service.ts`, `request-builder.ts`, `api.ts`.                 |
+| `metadata`   | `permissions/*`, `validators/*`, `metadata.ts`, `openapi-helpers.ts`.                      |
+| `navigation` | `api.navigation.ts` — `NavigationItem[]` ready for `NavigationService.registerItems(...)`. |
+
+## Pipeline
+
+```text
+sdk.config.json → loader → spec (YAML/JSON) → IR → emitters → writer → Angular CLI Tree
+```
+
+- `src/config/` — config schema + loader (supports JSONC and `.js`/`.cjs`).
+- `src/parser/` — OpenAPI → intermediate representation.
+- `src/emit/` — one module per output concern (models, operations, services, client, metadata, navigation, public-api).
+- `src/layout/` — post-emit layout transforms (e.g. `splitByDomain` reorganisation).
+- `src/writer/` — mode wrappers (standalone / library / secondary entrypoint).
+- `public-api.ts` — published TypeScript entrypoint for `@ojiepermana/angular/generator/api`.
+- `schematics/init/` — creates `sdk.config.json` from the example template.
+- `schematics/sdk/` — orchestrates engine and writes virtual files into the CLI `Tree`.
+
+## Generated runtime conventions
+
+- Tree-shakeable: `import { listUsers } from './sdk/fn/user/list-users'` pulls only one HTTP call.
+- Services: every operation gets `op()` (body `Observable<T>`) and `op$Response()` (full `StrictHttpResponse<T>`).
+- `RequestBuilder` is intentionally minimal — no `style`/`explode` logic — to keep the output lightweight.
+- All files carry a `DO NOT EDIT` banner and `/* eslint-disable */`.

package/fesm2022/ojiepermana-angular-sdk.mjs

@@ -0,0 +1,69 @@
+/**
+ * Public config shape for the SDK generator.
+ *
+ * Users place an `sdk.config.json` at the workspace root describing one or more
+ * generation targets. All paths are resolved relative to the workspace root
+ * (i.e. the directory containing the config file).
+ */
+const DEFAULT_BANNER = '/* eslint-disable */\n/* Auto-generated by @ojiepermana/angular/generator/api. DO NOT EDIT. */';
+const DEFAULT_FEATURES = {
+    models: true,
+    operations: true,
+    services: true,
+    client: true,
+    metadata: true,
+    navigation: true,
+};
+function resolveTarget(raw) {
+    if (!raw || typeof raw !== 'object') {
+        throw new Error('Invalid target: expected object');
+    }
+    if (!raw.input)
+        throw new Error('Target is missing required "input"');
+    if (!raw.output)
+        throw new Error('Target is missing required "output"');
+    const mode = raw.mode ?? 'standalone';
+    if (!['standalone', 'library', 'secondary-entrypoint'].includes(mode)) {
+        throw new Error(`Invalid target mode: ${mode}`);
+    }
+    const splitByDomain = raw.splitByDomain ?? mode === 'library';
+    return {
+        input: raw.input,
+        output: raw.output,
+        mode,
+        clientName: raw.clientName ?? 'Api',
+        packageName: raw.packageName ?? '@local/sdk',
+        packageVersion: raw.packageVersion ?? '0.0.1',
+        rootUrl: raw.rootUrl,
+        features: { ...DEFAULT_FEATURES, ...(raw.features ?? {}) },
+        splitByDomain,
+        splitDepth: raw.splitDepth === 'tag' ? 'tag' : 'service',
+        banner: raw.banner ?? DEFAULT_BANNER,
+    };
+}
+function resolveConfig(raw) {
+    if (!raw || typeof raw !== 'object') {
+        throw new Error('Invalid SDK config: root must be an object');
+    }
+    const cfg = raw;
+    if (!Array.isArray(cfg.targets) || cfg.targets.length === 0) {
+        throw new Error('Invalid SDK config: "targets" must be a non-empty array');
+    }
+    return cfg.targets.map(resolveTarget);
+}
+
+/*
+ * Public API Surface of @ojiepermana/angular-sdk
+ * (also re-exported as the secondary entrypoint @ojiepermana/angular/sdk)
+ *
+ * This package is primarily consumed as an Angular schematic collection
+ * (`init` and `sdk`). The TypeScript surface intentionally stays small and
+ * Node-free so it can be published as a standalone Angular library entry point.
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { resolveConfig, resolveTarget };
+//# sourceMappingURL=ojiepermana-angular-sdk.mjs.map

package/fesm2022/ojiepermana-angular-sdk.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ojiepermana-angular-sdk.mjs","sources":["../../../library/sdk/src/config/schema.ts","../../../library/sdk/public-api.ts","../../../library/sdk/ojiepermana-angular-sdk.ts"],"sourcesContent":["/**\n * Public config shape for the SDK generator.\n *\n * Users place an `sdk.config.json` at the workspace root describing one or more\n * generation targets. All paths are resolved relative to the workspace root\n * (i.e. the directory containing the config file).\n */\n\nexport type SdkOutputMode = 'standalone' | 'library' | 'secondary-entrypoint';\n\nexport interface SdkFeatureFlags {\n  /** Emit `models/*.ts` (type-only DTO interfaces). Default `true`. */\n  models?: boolean;\n  /** Emit tree-shakeable operation functions in `fn/<tag>/*.ts`. Default `true`. */\n  operations?: boolean;\n  /** Emit grouped Injectable service classes per tag. Default `true`. */\n  services?: boolean;\n  /** Emit the runtime client primitives (ApiConfiguration, BaseService, etc). Default `true`. */\n  client?: boolean;\n  /** Emit operation rules + field validators + permission helpers. Default `true`. */\n  metadata?: boolean;\n  /** Emit navigation tree derived from tags (parent, x-icon). Default `false`. */\n  navigation?: boolean;\n}\n\nexport interface SdkTargetConfig {\n  /** Path to OpenAPI 3.x spec (YAML or JSON). Required. */\n  input: string;\n  /** Output directory (relative to workspace root). Required. */\n  output: string;\n  /** Output mode. Defaults to `\"standalone\"`. */\n  mode?: SdkOutputMode;\n  /** Optional human-readable name used for logs & the generated `Api` class. */\n  clientName?: string;\n  /** Package name used when `mode === \"library\"`. */\n  packageName?: string;\n  /** Package version used when `mode === \"library\"`. Defaults to `0.0.1`. */\n  packageVersion?: string;\n  /** Default rootUrl baked into ApiConfiguration. Defaults to an empty string for same-origin requests. */\n  rootUrl?: string;\n  /** Feature toggles. Every feature defaults to `true` except `navigation` (default `true` too). */\n  features?: SdkFeatureFlags;\n  /**\n   * When `true`, reorganize emitted files into one folder per domain (derived\n   * from OpenAPI tags). Models shared by multiple domains live in `shared/`,\n   * domain-owned models live inside each domain. Defaults to `true` for\n   * `mode: \"library\"` and `false` otherwise.\n   */\n  splitByDomain?: boolean;\n  /**\n   * Granularity of `splitByDomain`. Only meaningful when `splitByDomain` is\n   * `true`. `'service'` (default) groups every tag under its root parent — one\n   * folder per backend service (e.g. all Role/Permission/... tags collapse into\n   * `access/`). `'tag'` emits one folder per leaf tag, nested under the parent\n   * chain (e.g. `storage/gcs/`, `storage/s3/`, `access/role/`).\n   */\n  splitDepth?: 'service' | 'tag';\n  /** Custom file banner. Defaults to a short auto-generated notice. */\n  banner?: string;\n}\n\nexport interface SdkConfig {\n  targets: SdkTargetConfig[];\n}\n\nexport interface ResolvedFeatureFlags {\n  models: boolean;\n  operations: boolean;\n  services: boolean;\n  client: boolean;\n  metadata: boolean;\n  navigation: boolean;\n}\n\nexport interface ResolvedSdkTarget {\n  input: string;\n  output: string;\n  mode: SdkOutputMode;\n  clientName: string;\n  packageName: string;\n  packageVersion: string;\n  rootUrl: string | undefined;\n  features: ResolvedFeatureFlags;\n  splitByDomain: boolean;\n  splitDepth: 'service' | 'tag';\n  banner: string;\n}\n\nconst DEFAULT_BANNER = '/* eslint-disable */\\n/* Auto-generated by @ojiepermana/angular/generator/api. DO NOT EDIT. */';\n\nconst DEFAULT_FEATURES: ResolvedFeatureFlags = {\n  models: true,\n  operations: true,\n  services: true,\n  client: true,\n  metadata: true,\n  navigation: true,\n};\n\nexport function resolveTarget(raw: SdkTargetConfig): ResolvedSdkTarget {\n  if (!raw || typeof raw !== 'object') {\n    throw new Error('Invalid target: expected object');\n  }\n  if (!raw.input) throw new Error('Target is missing required \"input\"');\n  if (!raw.output) throw new Error('Target is missing required \"output\"');\n\n  const mode: SdkOutputMode = raw.mode ?? 'standalone';\n  if (!['standalone', 'library', 'secondary-entrypoint'].includes(mode)) {\n    throw new Error(`Invalid target mode: ${mode}`);\n  }\n\n  const splitByDomain = raw.splitByDomain ?? mode === 'library';\n\n  return {\n    input: raw.input,\n    output: raw.output,\n    mode,\n    clientName: raw.clientName ?? 'Api',\n    packageName: raw.packageName ?? '@local/sdk',\n    packageVersion: raw.packageVersion ?? '0.0.1',\n    rootUrl: raw.rootUrl,\n    features: { ...DEFAULT_FEATURES, ...(raw.features ?? {}) },\n    splitByDomain,\n    splitDepth: raw.splitDepth === 'tag' ? 'tag' : 'service',\n    banner: raw.banner ?? DEFAULT_BANNER,\n  };\n}\n\nexport function resolveConfig(raw: unknown): ResolvedSdkTarget[] {\n  if (!raw || typeof raw !== 'object') {\n    throw new Error('Invalid SDK config: root must be an object');\n  }\n  const cfg = raw as SdkConfig;\n  if (!Array.isArray(cfg.targets) || cfg.targets.length === 0) {\n    throw new Error('Invalid SDK config: \"targets\" must be a non-empty array');\n  }\n  return cfg.targets.map(resolveTarget);\n}\n","/*\n * Public API Surface of @ojiepermana/angular-sdk\n * (also re-exported as the secondary entrypoint @ojiepermana/angular/sdk)\n *\n * This package is primarily consumed as an Angular schematic collection\n * (`init` and `sdk`). The TypeScript surface intentionally stays small and\n * Node-free so it can be published as a standalone Angular library entry point.\n */\n\nexport type {\n  ResolvedFeatureFlags,\n  ResolvedSdkTarget,\n  SdkConfig,\n  SdkFeatureFlags,\n  SdkOutputMode,\n  SdkTargetConfig,\n} from './src/config/schema';\nexport { resolveConfig, resolveTarget } from './src/config/schema';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"AAAA;;;;;;AAMG;AAkFH,MAAM,cAAc,GAAG,gGAAgG;AAEvH,MAAM,gBAAgB,GAAyB;AAC7C,IAAA,MAAM,EAAE,IAAI;AACZ,IAAA,UAAU,EAAE,IAAI;AAChB,IAAA,QAAQ,EAAE,IAAI;AACd,IAAA,MAAM,EAAE,IAAI;AACZ,IAAA,QAAQ,EAAE,IAAI;AACd,IAAA,UAAU,EAAE,IAAI;CACjB;AAEK,SAAU,aAAa,CAAC,GAAoB,EAAA;IAChD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AACnC,QAAA,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC;IACpD;IACA,IAAI,CAAC,GAAG,CAAC,KAAK;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC;IACrE,IAAI,CAAC,GAAG,CAAC,MAAM;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC;AAEvE,IAAA,MAAM,IAAI,GAAkB,GAAG,CAAC,IAAI,IAAI,YAAY;AACpD,IAAA,IAAI,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,sBAAsB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;AACrE,QAAA,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAA,CAAE,CAAC;IACjD;IAEA,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,IAAI,IAAI,KAAK,SAAS;IAE7D,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI;AACJ,QAAA,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,KAAK;AACnC,QAAA,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,YAAY;AAC5C,QAAA,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,OAAO;QAC7C,OAAO,EAAE,GAAG,CAAC,OAAO;AACpB,QAAA,QAAQ,EAAE,EAAE,GAAG,gBAAgB,EAAE,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE;QAC1D,aAAa;AACb,QAAA,UAAU,EAAE,GAAG,CAAC,UAAU,KAAK,KAAK,GAAG,KAAK,GAAG,SAAS;AACxD,QAAA,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,cAAc;KACrC;AACH;AAEM,SAAU,aAAa,CAAC,GAAY,EAAA;IACxC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AACnC,QAAA,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC;IAC/D;IACA,MAAM,GAAG,GAAG,GAAgB;AAC5B,IAAA,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE;AAC3D,QAAA,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC;IAC5E;IACA,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;AACvC;;ACzIA;;;;;;;AAOG;;ACPH;;AAEG;;;;"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@ojiepermana/angular-sdk",
+  "version": "22.0.27",
+  "description": "OpenAPI 3.x → Angular SDK generator (schematics + config surface) for @ojiepermana/angular.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/edsis/angular.git"
+  },
+  "homepage": "https://github.com/edsis/angular#readme",
+  "bugs": {
+    "url": "https://github.com/edsis/angular/issues"
+  },
+  "peerDependencies": {
+    "@angular/common": ">=22.0.0",
+    "@angular/core": ">=22.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.8.1"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/ojiepermana-angular-sdk.mjs",
+  "typings": "types/ojiepermana-angular-sdk.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/ojiepermana-angular-sdk.d.ts",
+      "default": "./fesm2022/ojiepermana-angular-sdk.mjs"
+    }
+  },
+  "type": "module"
+}

package/types/ojiepermana-angular-sdk.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Public config shape for the SDK generator.
+ *
+ * Users place an `sdk.config.json` at the workspace root describing one or more
+ * generation targets. All paths are resolved relative to the workspace root
+ * (i.e. the directory containing the config file).
+ */
+type SdkOutputMode = 'standalone' | 'library' | 'secondary-entrypoint';
+interface SdkFeatureFlags {
+    /** Emit `models/*.ts` (type-only DTO interfaces). Default `true`. */
+    models?: boolean;
+    /** Emit tree-shakeable operation functions in `fn/<tag>/*.ts`. Default `true`. */
+    operations?: boolean;
+    /** Emit grouped Injectable service classes per tag. Default `true`. */
+    services?: boolean;
+    /** Emit the runtime client primitives (ApiConfiguration, BaseService, etc). Default `true`. */
+    client?: boolean;
+    /** Emit operation rules + field validators + permission helpers. Default `true`. */
+    metadata?: boolean;
+    /** Emit navigation tree derived from tags (parent, x-icon). Default `false`. */
+    navigation?: boolean;
+}
+interface SdkTargetConfig {
+    /** Path to OpenAPI 3.x spec (YAML or JSON). Required. */
+    input: string;
+    /** Output directory (relative to workspace root). Required. */
+    output: string;
+    /** Output mode. Defaults to `"standalone"`. */
+    mode?: SdkOutputMode;
+    /** Optional human-readable name used for logs & the generated `Api` class. */
+    clientName?: string;
+    /** Package name used when `mode === "library"`. */
+    packageName?: string;
+    /** Package version used when `mode === "library"`. Defaults to `0.0.1`. */
+    packageVersion?: string;
+    /** Default rootUrl baked into ApiConfiguration. Defaults to an empty string for same-origin requests. */
+    rootUrl?: string;
+    /** Feature toggles. Every feature defaults to `true` except `navigation` (default `true` too). */
+    features?: SdkFeatureFlags;
+    /**
+     * When `true`, reorganize emitted files into one folder per domain (derived
+     * from OpenAPI tags). Models shared by multiple domains live in `shared/`,
+     * domain-owned models live inside each domain. Defaults to `true` for
+     * `mode: "library"` and `false` otherwise.
+     */
+    splitByDomain?: boolean;
+    /**
+     * Granularity of `splitByDomain`. Only meaningful when `splitByDomain` is
+     * `true`. `'service'` (default) groups every tag under its root parent — one
+     * folder per backend service (e.g. all Role/Permission/... tags collapse into
+     * `access/`). `'tag'` emits one folder per leaf tag, nested under the parent
+     * chain (e.g. `storage/gcs/`, `storage/s3/`, `access/role/`).
+     */
+    splitDepth?: 'service' | 'tag';
+    /** Custom file banner. Defaults to a short auto-generated notice. */
+    banner?: string;
+}
+interface SdkConfig {
+    targets: SdkTargetConfig[];
+}
+interface ResolvedFeatureFlags {
+    models: boolean;
+    operations: boolean;
+    services: boolean;
+    client: boolean;
+    metadata: boolean;
+    navigation: boolean;
+}
+interface ResolvedSdkTarget {
+    input: string;
+    output: string;
+    mode: SdkOutputMode;
+    clientName: string;
+    packageName: string;
+    packageVersion: string;
+    rootUrl: string | undefined;
+    features: ResolvedFeatureFlags;
+    splitByDomain: boolean;
+    splitDepth: 'service' | 'tag';
+    banner: string;
+}
+declare function resolveTarget(raw: SdkTargetConfig): ResolvedSdkTarget;
+declare function resolveConfig(raw: unknown): ResolvedSdkTarget[];
+
+export { resolveConfig, resolveTarget };
+export type { ResolvedFeatureFlags, ResolvedSdkTarget, SdkConfig, SdkFeatureFlags, SdkOutputMode, SdkTargetConfig };