@pikku/addon-ollama 0.1.6 → 0.1.7

package/dist/.pikku/addon/scopes/pikku-flags-manifest.gen.ts

@@ -0,0 +1,52 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * This file was generated by the @pikku/cli
+ */
+import type { DeclaredFlag, FeatureFlagDefinitionsMeta } from '@pikku/core/flag'
+import {
+  compiledFallbackSnapshot,
+  flattenFeatureFlagDefinitions,
+} from '@pikku/core/flag'
+import type { FeatureFlagName } from './pikku-flags.gen.js'
+import definitions from './pikku-flags-meta.gen.json' with { type: 'json' }
+
+/**
+ * The declared flag set, for a FeatureFlagStore to sync into its store.
+ *
+ * Derived from the metadata sidecar rather than inlined, so the import above
+ * forces tsc to emit the .json alongside this file — an addon publishes only
+ * its compiled output, and a host reads that .json to merge the addon's flags
+ * into its own union.
+ *
+ * Additive on removal: a deleted declaration leaves the row marked
+ * `declared: false` rather than switching a feature off on deploy. Use
+ * `pikku flags prune` to remove them.
+ */
+export const declaredFeatureFlags: DeclaredFlag[] = flattenFeatureFlagDefinitions(
+  Object.values(definitions as FeatureFlagDefinitionsMeta)
+)
+
+/**
+ * Declared flags, keyed by name. Rendered by the console beside each switch.
+ *
+ * Keyed by `FeatureFlagName` so a misspelled lookup is a type error, which is
+ * the whole point of generating the union. The assertion is what
+ * `Object.fromEntries` costs — it returns an index signature — and it is
+ * sound here because both this object and the union are built from
+ * `declaredFeatureFlags`, so every key of the union is present.
+ */
+export const featureFlagsMeta = Object.fromEntries(
+  declaredFeatureFlags.map((flag) => [flag.name, flag])
+) as Record<FeatureFlagName, DeclaredFlag>
+
+/**
+ * What a flag source falls back to when its backing store cannot be read: every
+ * declared flag on, no rollout, no overrides.
+ *
+ * Failing open is deliberate. A flag store is not an authorization boundary —
+ * `scopes:` is — so an unreadable config must not take the product down with
+ * it.
+ */
+export const featureFlagsFallback = compiledFallbackSnapshot(declaredFeatureFlags)

package/dist/.pikku/addon/scopes/pikku-flags.gen.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * This file was generated by the @pikku/cli
+ */
+/** Every feature flag declared in this application. */
+export type FeatureFlagName = never;
+//# sourceMappingURL=pikku-flags.gen.d.ts.map

package/dist/.pikku/addon/scopes/pikku-flags.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-flags.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-flags.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AACH,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,KAAK,CAAA"}

package/dist/.pikku/addon/scopes/pikku-flags.gen.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pikku-flags.gen.js.map

package/dist/.pikku/addon/scopes/pikku-flags.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-flags.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-flags.gen.ts"],"names":[],"mappings":""}

package/dist/.pikku/addon/scopes/pikku-flags.gen.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * This file was generated by the @pikku/cli
+ */
+/** Every feature flag declared in this application. */
+export type FeatureFlagName = never

package/dist/.pikku/addon/scopes/pikku-roles.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * This file was generated by the @pikku/cli

package/dist/.pikku/addon/scopes/pikku-roles.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-roles.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-roles.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAA6B,MAAM,kBAAkB,CAAA;AAI7E;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,CAAA;AAElC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,EAAE,UAAU,EAEpC,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAExD,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OACmB,CAAA"}
+{"version":3,"file":"pikku-roles.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-roles.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAA6B,MAAM,kBAAkB,CAAA;AAI7E;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,CAAA;AAElC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,EAAE,UAAU,EAEpC,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAExD,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,YAAY,SAAU,MAAM,KAAG,OACmB,CAAA"}

package/dist/.pikku/addon/scopes/pikku-roles.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * This file was generated by the @pikku/cli

package/dist/.pikku/addon/scopes/pikku-scope-types.gen.d.ts

@@ -1,6 +1,7 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 export { defineScope } from '@pikku/core/scope';
 export { defineSystemRole } from '@pikku/core/role';
+export { defineFeatureFlags } from '@pikku/core/flag';
 //# sourceMappingURL=pikku-scope-types.gen.d.ts.map

package/dist/.pikku/addon/scopes/pikku-scope-types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-scope-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-scope-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"pikku-scope-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-scope-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/.pikku/addon/scopes/pikku-scope-types.gen.js

@@ -1,6 +1,7 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 export { defineScope } from '@pikku/core/scope';
 export { defineSystemRole } from '@pikku/core/role';
+export { defineFeatureFlags } from '@pikku/core/flag';
 //# sourceMappingURL=pikku-scope-types.gen.js.map

package/dist/.pikku/addon/scopes/pikku-scope-types.gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-scope-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-scope-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"pikku-scope-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-scope-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/.pikku/addon/scopes/pikku-scope-types.gen.ts

@@ -1,5 +1,6 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 export { defineScope } from '@pikku/core/scope'
 export { defineSystemRole } from '@pikku/core/role'
+export { defineFeatureFlags } from '@pikku/core/flag'

package/dist/.pikku/addon/scopes/pikku-scopes.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * This file was generated by the @pikku/cli

package/dist/.pikku/addon/scopes/pikku-scopes.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * This file was generated by the @pikku/cli

package/dist/.pikku/addon/scopes/pikku-virtual-users-meta.gen.json

@@ -0,0 +1 @@
+{}

package/dist/.pikku/addon/scopes/pikku-virtual-users.gen.d.ts

@@ -0,0 +1,27 @@
+import type { VirtualUserMeta, VirtualUsersMeta } from '@pikku/core/virtual-user';
+import type { CoreVirtualUser } from '@pikku/core/virtual-user';
+import type { SystemRoleName } from './pikku-roles.gen.js';
+/** Every environment configured in pikku.config.json. */
+type EnvironmentName = never;
+/**
+ * A virtual user whose roles are checked against `defineSystemRole` and whose
+ * environments are checked against the config.
+ *
+ * Omitting `environments` means every environment except the ones flagged
+ * `production: true`. Naming a production one additionally requires
+ * `disposition: 'accountable'`, which the type cannot express and `pikku`
+ * refuses at build time.
+ */
+type TypedVirtualUser = Omit<CoreVirtualUser, 'roles' | 'environments'> & {
+    roles?: SystemRoleName[];
+    environments?: EnvironmentName[];
+};
+/**
+ * Declare the people who use this application.
+ */
+export declare const defineVirtualUsers: (virtualUsers: Record<string, TypedVirtualUser>) => void;
+/** Declared virtual users, keyed by id. Read by the console and `pikku virtual-user`. */
+export declare const VIRTUAL_USERS: VirtualUsersMeta;
+export declare const VIRTUAL_USER_LIST: VirtualUserMeta[];
+export {};
+//# sourceMappingURL=pikku-virtual-users.gen.d.ts.map

package/dist/.pikku/addon/scopes/pikku-virtual-users.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-virtual-users.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-virtual-users.gen.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAG1D,yDAAyD;AACzD,KAAK,eAAe,GAAG,KAAK,CAAA;AAE5B;;;;;;;;GAQG;AACH,KAAK,gBAAgB,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,cAAc,CAAC,GAAG;IACxE,KAAK,CAAC,EAAE,cAAc,EAAE,CAAA;IACxB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAA;CACjC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,iBAAkB,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,KAAG,IAC9C,CAAA;AAEtC,yFAAyF;AACzF,eAAO,MAAM,aAAa,EAAE,gBAA6D,CAAA;AAEzF,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAAiC,CAAA"}

package/dist/.pikku/addon/scopes/pikku-virtual-users.gen.js

@@ -0,0 +1,16 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * This file was generated by the @pikku/cli
+ */
+import { defineVirtualUsers as defineVirtualUsersCore } from '@pikku/core/virtual-user';
+import definitions from './pikku-virtual-users-meta.gen.json' with { type: 'json' };
+/**
+ * Declare the people who use this application.
+ */
+export const defineVirtualUsers = (virtualUsers) => defineVirtualUsersCore(virtualUsers);
+/** Declared virtual users, keyed by id. Read by the console and `pikku virtual-user`. */
+export const VIRTUAL_USERS = definitions;
+export const VIRTUAL_USER_LIST = Object.values(VIRTUAL_USERS);
+//# sourceMappingURL=pikku-virtual-users.gen.js.map

package/dist/.pikku/addon/scopes/pikku-virtual-users.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-virtual-users.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-virtual-users.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AACH,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAIvF,OAAO,WAAW,MAAM,qCAAqC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAmBnF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,YAA8C,EAAQ,EAAE,CACzF,sBAAsB,CAAC,YAAY,CAAC,CAAA;AAEtC,yFAAyF;AACzF,MAAM,CAAC,MAAM,aAAa,GAAqB,WAA0C,CAAA;AAEzF,MAAM,CAAC,MAAM,iBAAiB,GAAsB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA"}

package/dist/.pikku/addon/scopes/pikku-virtual-users.gen.ts

@@ -0,0 +1,39 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * This file was generated by the @pikku/cli
+ */
+import { defineVirtualUsers as defineVirtualUsersCore } from '@pikku/core/virtual-user'
+import type { VirtualUserMeta, VirtualUsersMeta } from '@pikku/core/virtual-user'
+import type { CoreVirtualUser } from '@pikku/core/virtual-user'
+import type { SystemRoleName } from './pikku-roles.gen.js'
+import definitions from './pikku-virtual-users-meta.gen.json' with { type: 'json' }
+
+/** Every environment configured in pikku.config.json. */
+type EnvironmentName = never
+
+/**
+ * A virtual user whose roles are checked against `defineSystemRole` and whose
+ * environments are checked against the config.
+ *
+ * Omitting `environments` means every environment except the ones flagged
+ * `production: true`. Naming a production one additionally requires
+ * `disposition: 'accountable'`, which the type cannot express and `pikku`
+ * refuses at build time.
+ */
+type TypedVirtualUser = Omit<CoreVirtualUser, 'roles' | 'environments'> & {
+  roles?: SystemRoleName[]
+  environments?: EnvironmentName[]
+}
+
+/**
+ * Declare the people who use this application.
+ */
+export const defineVirtualUsers = (virtualUsers: Record<string, TypedVirtualUser>): void =>
+  defineVirtualUsersCore(virtualUsers)
+
+/** Declared virtual users, keyed by id. Read by the console and `pikku virtual-user`. */
+export const VIRTUAL_USERS: VirtualUsersMeta = definitions as unknown as VirtualUsersMeta
+
+export const VIRTUAL_USER_LIST: VirtualUserMeta[] = Object.values(VIRTUAL_USERS)

package/dist/.pikku/addon/secrets/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/secrets` resolves here.

package/dist/.pikku/addon/secrets/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/secrets` resolves here.

package/dist/.pikku/addon/secrets/index.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/secrets` resolves here.

package/dist/.pikku/addon/secrets/pikku-secret-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 export { defineSecret } from '@pikku/core/secret';
 //# sourceMappingURL=pikku-secret-types.gen.d.ts.map

package/dist/.pikku/addon/secrets/pikku-secret-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 export { defineSecret } from '@pikku/core/secret';
 //# sourceMappingURL=pikku-secret-types.gen.js.map

package/dist/.pikku/addon/secrets/pikku-secret-types.gen.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 export { defineSecret } from '@pikku/core/secret'

package/dist/.pikku/addon/secrets/pikku-secrets.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 import type { SecretService } from '@pikku/core/services';
@@ -11,7 +11,15 @@ import type { SecretService } from '@pikku/core/services';
  * sidecar is not part of `#pikku/secrets`.
  */
 import './pikku-secrets-meta.gen.json';
+/**
+ * Every secret this project declares with `defineSecret`, keyed by name. It is
+ * what gives `secrets.getSecret('NAME')` a real type.
+ */
 export type CredentialsMap = {};
+/**
+ * The `secrets` service as this project sees it: `getSecret('NAME')` resolves
+ * the value's type from `CredentialsMap` instead of returning `unknown`.
+ */
 export declare class TypedSecretService extends CoreTypedSecretService<CredentialsMap> {
     constructor(secrets: SecretService);
 }

package/dist/.pikku/addon/secrets/pikku-secrets.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-secrets.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/secrets/pikku-secrets.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAEnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD;;;;;;GAMG;AACH,OAAO,+BAA+B,CAAsB;AAE5D,MAAM,MAAM,cAAc,GAAG,EAE5B,CAAA;AAMD,qBAAa,kBAAmB,SAAQ,sBAAsB,CAAC,cAAc,CAAC;gBAChE,OAAO,EAAE,aAAa;CAGnC"}
+{"version":3,"file":"pikku-secrets.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/secrets/pikku-secrets.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAEnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD;;;;;;GAMG;AACH,OAAO,+BAA+B,CAAsB;AAE5D;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,EAE5B,CAAA;AAMD;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,sBAAsB,CAAC,cAAc,CAAC;IAC5E,YAAY,OAAO,EAAE,aAAa,EAEjC;CACF"}

package/dist/.pikku/addon/secrets/pikku-secrets.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 /**
@@ -11,6 +11,10 @@ import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/servic
  */
 import './pikku-secrets-meta.gen.json' with { type: 'json' };
 const CREDENTIALS_META = {};
+/**
+ * The `secrets` service as this project sees it: `getSecret('NAME')` resolves
+ * the value's type from `CredentialsMap` instead of returning `unknown`.
+ */
 export class TypedSecretService extends CoreTypedSecretService {
     constructor(secrets) {
         super(secrets, CREDENTIALS_META);

package/dist/.pikku/addon/secrets/pikku-secrets.gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-secrets.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/secrets/pikku-secrets.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAGnF;;;;;;GAMG;AACH,OAAO,+BAA+B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAM5D,MAAM,gBAAgB,GAAmC,EAExD,CAAA;AAED,MAAM,OAAO,kBAAmB,SAAQ,sBAAsC;IAC5E,YAAY,OAAsB;QAChC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;IAClC,CAAC;CACF"}
+{"version":3,"file":"pikku-secrets.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/secrets/pikku-secrets.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAGnF;;;;;;GAMG;AACH,OAAO,+BAA+B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAU5D,MAAM,gBAAgB,GAAmC,EAExD,CAAA;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,sBAAsC;IAC5E,YAAY,OAAsB;QAChC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;IAClC,CAAC;CACF"}

package/dist/.pikku/addon/secrets/pikku-secrets.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services'
 import type { CredentialMeta } from '@pikku/core/services'
@@ -13,6 +13,10 @@ import type { SecretService } from '@pikku/core/services'
  */
 import './pikku-secrets-meta.gen.json' with { type: 'json' }
 
+/**
+ * Every secret this project declares with `defineSecret`, keyed by name. It is
+ * what gives `secrets.getSecret('NAME')` a real type.
+ */
 export type CredentialsMap = {
 
 }
@@ -21,6 +25,10 @@ const CREDENTIALS_META: Record<string, CredentialMeta> = {
 
 }
 
+/**
+ * The `secrets` service as this project sees it: `getSecret('NAME')` resolves
+ * the value's type from `CredentialsMap` instead of returning `unknown`.
+ */
 export class TypedSecretService extends CoreTypedSecretService<CredentialsMap> {
   constructor(secrets: SecretService) {
     super(secrets, CREDENTIALS_META)

package/dist/.pikku/addon/services/pikku-meta-service.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export declare class PikkuMetaService extends LocalMetaService {

package/dist/.pikku/addon/services/pikku-meta-service.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-meta-service.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/services/pikku-meta-service.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAElE,qBAAa,gBAAiB,SAAQ,gBAAgB;;CAIrD"}
+{"version":3,"file":"pikku-meta-service.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/services/pikku-meta-service.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAElE,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,cAEC;CACF"}

package/dist/.pikku/addon/services/pikku-meta-service.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export class PikkuMetaService extends LocalMetaService {

package/dist/.pikku/addon/services/pikku-meta-service.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta'
 

package/dist/.pikku/addon/setup/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

package/dist/.pikku/addon/setup/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

package/dist/.pikku/addon/setup/index.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

package/dist/.pikku/addon/setup/pikku-addon-setup-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Addon package types for pikkuAddonConfig and pikkuAddonServices
@@ -25,7 +25,7 @@ export type AddonBaseServices = {
  * Unlike pikkuConfig, this receives AddonBaseServices (logger, variables, secrets)
  * from the parent application, so addon packages can read variables/secrets during config creation.
  */
-export declare const pikkuAddonConfig: <ExistingServices extends Omit<Partial<SingletonServices>, "variables" | "secrets"> & AddonBaseServices>(func: (services: ExistingServices) => Promise<Config>) => CreateConfig<Config>;
+export declare const pikkuAddonConfig: <ExistingServices extends Omit<Partial<SingletonServices>, 'variables' | 'secrets'> & AddonBaseServices>(func: (services: ExistingServices) => Promise<Config>) => CreateConfig<Config>;
 /**
  * Creates a Pikku singleton services factory for addon packages.
  * Unlike pikkuServices, this expects the parent application to provide
@@ -46,7 +46,7 @@ export declare const pikkuAddonConfig: <ExistingServices extends Omit<Partial<Si
  * })
  * ```
  */
-export declare const pikkuAddonServices: <T extends Record<string, any>, ExistingServices extends Omit<Partial<SingletonServices>, "variables" | "secrets"> & AddonBaseServices>(func: (config: Config, services: ExistingServices) => Promise<T>) => (config: Config, existingServices?: Partial<SingletonServices>) => Promise<RequiredSingletonServices>;
+export declare const pikkuAddonServices: <T extends Record<string, any>, ExistingServices extends Omit<Partial<SingletonServices>, 'variables' | 'secrets'> & AddonBaseServices>(func: (config: Config, services: ExistingServices) => Promise<T>) => (config: Config, existingServices?: Partial<SingletonServices>) => Promise<RequiredSingletonServices>;
 /**
  * Creates a Pikku wire services factory for addon packages.
  * Wire services are created per-request and have access to the HTTP request context.
@@ -62,5 +62,5 @@ export declare const pikkuAddonServices: <T extends Record<string, any>, Existin
  * })
  * ```
  */
-export declare const pikkuAddonWireServices: <ExistingServices extends Omit<Partial<SingletonServices>, "variables" | "secrets"> & AddonBaseServices>(func: (services: ExistingServices, wire: PikkuWire) => Promise<Record<string, any>>) => any;
+export declare const pikkuAddonWireServices: <ExistingServices extends Omit<Partial<SingletonServices>, 'variables' | 'secrets'> & AddonBaseServices>(func: (services: ExistingServices, wire: PikkuWire) => Promise<Record<string, any>>) => any;
 //# sourceMappingURL=pikku-addon-setup-types.gen.d.ts.map

package/dist/.pikku/addon/setup/pikku-addon-setup-types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-addon-setup-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/setup/pikku-addon-setup-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAA;AACnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAM3E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACnC,SAAS,EAAE,qBAAqB,CAAA;IAChC,OAAO,EAAE,kBAAkB,CAAA;CAC5B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,EACrI,MAAM,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,CAAC,KACpD,YAAY,CAAC,MAAM,CAKrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,EACtK,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,MAElD,QAAQ,MAAM,EAAE,mBAAmB,OAAO,CAAC,iBAAiB,CAAC,KAAG,OAAO,CAAC,yBAAyB,CAchH,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,GAAI,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,EAC3I,MAAM,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAM7E,GACP,CAAA"}
+{"version":3,"file":"pikku-addon-setup-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/setup/pikku-addon-setup-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAA;AACnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAM3E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACnC,SAAS,EAAE,qBAAqB,CAAA;IAChC,OAAO,EAAE,kBAAkB,CAAA;CAC5B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,QAC/H,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,CAAC,KACpD,YAAY,CAAC,MAAM,CAKrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,QAChK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,cAE1C,MAAM,qBAAqB,OAAO,CAAC,iBAAiB,CAAC,KAAG,OAAO,CAAC,yBAAyB,CAchH,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,GAAI,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,QACrI,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAM7E,GACP,CAAA"}

package/dist/.pikku/addon/setup/pikku-addon-setup-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Addon package types for pikkuAddonConfig and pikkuAddonServices

package/dist/.pikku/addon/setup/pikku-addon-setup-types.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Addon package types for pikkuAddonConfig and pikkuAddonServices

package/dist/.pikku/addon/setup/pikku-setup-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Config and service factory definitions, declared once per application
@@ -8,6 +8,10 @@ import { CreateWireServices } from '@pikku/core/types';
 import type { SingletonServices } from '../function/pikku-function-types.gen.js';
 import type { Config } from '../../../types/application-types.d.js';
 import type { RequiredSingletonServices, RequiredWireServices } from '../pikku-services.gen.js';
+/**
+ * This project's own config — whatever `createConfig` returns. Every singleton
+ * service is built from it.
+ */
 export type { Config };
 /**
  * Creates a Pikku config factory.
@@ -16,15 +20,7 @@ export type { Config };
  * @param func - Config factory function that returns your application's config
  * @returns The config factory function
  *
- * @example
- * ```typescript
- * export const createConfig = pikkuConfig(async () => {
- *   return {
- *     apiUrl: process.env.API_URL || 'http://localhost:3000',
- *     dbUrl: process.env.DATABASE_URL
- *   }
- * })
- * ```
+ * @example snippet: pikkuConfig
  */
 export declare const pikkuConfig: (func: (variables?: any, ...args: any[]) => Promise<Config>) => (variables?: any, ...args: any[]) => Promise<Config>;
 /**
@@ -45,7 +41,7 @@ export declare const pikkuConfig: (func: (variables?: any, ...args: any[]) => Pr
  * })
  * ```
  */
-export declare const pikkuServices: (func: (config: Config, existingServices: Partial<SingletonServices>) => Promise<Partial<Omit<RequiredSingletonServices, "auth">>>) => (config: Config, existingServices?: Partial<SingletonServices>) => Promise<RequiredSingletonServices>;
+export declare const pikkuServices: (func: (config: Config, existingServices: Partial<SingletonServices>) => Promise<Partial<Omit<RequiredSingletonServices, 'auth'>>>) => (config: Config, existingServices?: Partial<SingletonServices>) => Promise<RequiredSingletonServices>;
 /**
  * Creates a Pikku wire services factory.
  * Use this to define services that are created per-request/session.
@@ -53,15 +49,7 @@ export declare const pikkuServices: (func: (config: Config, existingServices: Pa
  * @param func - Wire services factory function
  * @returns The wire services factory function
  *
- * @example
- * ```typescript
- * export const createWireServices = pikkuWireServices(async (services, wire) => {
- *   const session = await wire.session?.get()
- *   return {
- *     userCache: new UserCache(session?.userId)
- *   }
- * })
- * ```
+ * @example snippet: shopWireServices
  */
 export declare const pikkuWireServices: (func: (services: SingletonServices, wire: any) => Promise<RequiredWireServices>) => CreateWireServices;
 //# sourceMappingURL=pikku-setup-types.gen.d.ts.map

package/dist/.pikku/addon/setup/pikku-setup-types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-setup-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/setup/pikku-setup-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAA;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAA;AACnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/F,YAAY,EAAE,MAAM,EAAE,CAAA;AAEtB;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,kBAAvC,GAAG,WAAW,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAClD,CAAA;AAET;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,GACxB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,CAAC,MAEnH,QAAQ,MAAM,EAAE,mBAAkB,OAAO,CAAC,iBAAiB,CAAM,uCAoBhF,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,CACJ,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,GAAG,KACN,OAAO,CAAC,oBAAoB,CAAC,KACjC,kBAIF,CAAA"}
+{"version":3,"file":"pikku-setup-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/setup/pikku-setup-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAA;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAA;AACnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/F;;;GAGG;AACH,YAAY,EAAE,MAAM,EAAE,CAAA;AAEtB;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,SAChB,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,kBAAvC,GAAG,WAAW,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAClD,CAAA;AAET;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,SAClB,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,CAAC,cAE3G,MAAM,qBAAoB,OAAO,CAAC,iBAAiB,CAAC,uCAgC3E,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,SACtB,CACJ,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,GAAG,KACN,OAAO,CAAC,oBAAoB,CAAC,KACjC,kBAIF,CAAA"}